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SIP TRAP MASK (M5) REGISTER 


The SIP Trap Mask, or M5, register is an 8-bit control register residing in the SIP but with a 
copy in the CP. Both versions are set to 0 upon CP initialization and both may be modified with 
an MTM instruction (see Section 5). If only the SIP is initialized, the CP copy of the register is not 
cleared, and the contents of both versions must be reestablished with an MTM. 


The format of the M5-register is as tollows: 
0 | 2 3 4 5 6 7 
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Precision error trap mask 
Significance error trap mask 


: Exponent underflow trap mask 
SOFTWARE SIMULATION OF THE SCIENTIFIC INSTRUCTION PROCESSOR 


For systems on which a Scientific Instruction Processor (SIP) is not available, GCOS provides 
the equivalent SIP functions through software simulation. Two simulators are available: the 
Single-Precision SIP Simulator (SSIP) and the Double-Precision SIP Simulator (DSIP). If a 
configuration is to support scientific instructions when a SIP is not present, SSIP or DSIP must 
be specified in the CLM directive SYS for MOD 400, or DSIP must be specified in SYSTEM 
macro routine for MOD 600. (See System Building manual.) 

The DSIP simulates all functions of the SIP. The SSIP is partial simulator which is available 
in MOD 400 only. The simulators are entered via trap vector 3 (for scientific floating-point 
instructions) or trap vector 5 (for scientific branch instructions). 


Note the following considerations with respect to the use of the SSIP. See also the Section 
“Scientific Instructions” later in this manual. 


e SSIP uses registers R4, R5, and R7 to simulate a scientific register (assumed to be $S1). A 
task that executes scientific instructions that might be simulated by SSIP should dedicate 
these three registers to the use of the simulator. 


e SSIP uses the CPU-1 register to store the results of a scientific compare instead of 
simulating the scientific indicator register. Thus, if scientific compare instructions are to 
be simulated by SSIP (as opposed to being simulated by DSIP or executed by the SIP), then: 
— Either CPU branch instructions or simulated SIP branch instructions may be used to 
test these indicators. The simulated SIP branch instructions are recommended since 
they are upward compatible with the DSIP and the SIP hardware. 

— Execution of scientific instructions alters the CPU I-register instead of the SIP’s SI 
register. 

e The SSIP does not support the MTM or STM instruction on Models 20 and 30. 


e SSIP rounds results when appropriate; DSIP truncates results unless otherwise in- 
structed. Thus, results produced by the SSIP may not agree exactly with those produced by 
the DSIP. 


COMMERCIAL PROCESSOR REGISTERS 


The Commercial Processor, an optional hardware unit, contains two registers: the Commer- 
cial Processor mode register, and the Commercial Processor indicator register. 


COMMERCIAL PROCESSOR MODE REGISTER 


The 8-bit Commercial Processor mode register is a copy of the M3 register (in the CPU) which 

is provided for use with the Commercial Processor. Both are set to zero at initialization of the 

CPU. Both registers may be modified with an MTM instruction. If only the Commercial 

Processor is initialized, the M3 register is not cleared, and the contents of both registers must be 

established with an MTM instruction. The format of the Commercial Processor mode register 
and the. M3 register is shown below. When set to binary 1, the bits have the following meanings: 
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Trap on truncation 
Trap on overflow 


Note that, although the contents of the Commercial Processor mode register is not saved, the 
equivalent information in the M3 register is saved or restored as a function of the mask bits in 


the interrupt save area. When a restore is done, the restored value is sent to the Commercial 
Processor by the CPU. 


COMMERCIAL PROCESSOR INDICATOR REGISTER 


The 8-bit Commercial Processor indicator register is cleared at initialization. During the 
execution of an instruction that affects the register, only the bits pertinent to the instruction are 
preset (set or reset). All other bits remain unchanged. During the execution of a branch 
instruction, all bits including the one being tested are left unchanged. When set to binary 1, the 


bits have the following meaning: 
0 | Va 5 6 / 
QLT error 
Result of 


last compare is: 


Less than 
Greater than 


Sign fault 
(negative operand is stored 
in unsigned field) 


Alphanumeric result is truncated 


Overflow occurred during 
decimal instruction 


The contents of the Commercial Processor indicator register will be saved or restored as a 
function of the mask bits in the interrupt save area. 


SOFTWARE SIMULATION OF THE COMMERCIAL PROCESSOR 


For systems on which a Commercial Instruction Processor (CIP) is not available, GCOS 
provides a subset of the CIP instructions through software simulation. The CIP simulator is 
entered via trap vector 5. 


Note the following considerations with respect to the use of the CIP simulator. 


e The Alphanumeric Search (SRCH) and Alphanumeric Verify (VRFY) opcodes are not 
supported. 


e On Model 30, the CIP simulator supports the MTM, STM, LRDB, and SRDB instructions. 
e On Model 20, the CIP simulator supports the MTM and STM instructions. 


e Bit 7 of the Commercial Processor Mode Register must be set to zero. 
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ARITHMETIC CONSTANTS 


An arithmetic constant specifies the value of a real number. An arithmetic constant is either a 
binary integer constant, a decimal integer constant, a fixed-point constant, or a floating-point 
constant. 


BINARY INTEGER CONSTANTS 


Binary integer constants can be represented in decimal or hexadecimal notation. They may be 
preceded by a plus(+) or minus(— ) sign, indicating a positive or negative value respectively, and 
must be within the range — 32768 to + 32767; if unsigned, a binary integer constant is assumed 
to be positive. 


* | | n{n...] 
— X‘hfh...) 


a 

Specifies whether the value is positive (+, the default value) or negative (—). 
n[n...] 

Specify decimal digits. 
hfh...] 

Specify hexadecimal digits 


Binary Integer Constants in Decimal Notation 


A binary integer constant expressed in decimal notation is written as a character string 
composed of the decimal digits 0 through 9. The following examples illustrate valid binary 
integer constants in decimal notation. 


1. 31764 
2. +4652 
3. —6781 


Binary Integer Constants in Hexadecimal Notation 


A binary integer constant expressed in hexadecimal notation is written as the letter X 
followed by a character string composed of the hexadecimal digits 0 through 9 and A through F 
(the lowercase letters a through f are considered equivalent to the corresponding uppercase 
letters) within apostrophes. The following examples illustrate binary integer constants in 
hexadecimal notation. 


1 +X'2F 
2. X°7FFE 
3. —X‘8000’ 


The decimal equivalent of these examples is +47, +32767 and — 32768 respectively as can be 
determined by reference to Table B-3. 


DECIMAL INTEGER CONSTANTS 


Decimal integer constants are represented by a letter from the set L,T,O,N,P,U followed by a 
character string enclosed in apostrophes. In general, they may be preceded by a plus (+) or 
minus (—) sign indicating a positive or negative value. The letter indicates whether the value is 
internally represented as a packed or unpacked number and designates the internal sign 
convention. The character string is composed of the digits 0 through 9. Decimal integer 
constants begin at a word boundary and occupy an integral number of words, possibly including 
trailing digits which may be unused. 
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Unpacked Decimal Integers 


The prefix letter designating the internal sign convention and the range of values allowed for 
each convention of unpacked decimal integers are shown in Table 2-3. 


TABLE 2-3. INTERNAL SIGN CONVENTION AND RANGE OF VALUES FOR UNPACKED 


DECIMAL INTEGERS 
Sign Convention Letter Range of Values 
Leading separate L —10°<n<+10” 
Trailing separate T —10°<n<+10” 
Trailing overpunch O —10#<n<+10" 
Unsigned N O<n<+10" 


The storage formats for separate signed unpacked decimal integers are as follows: 


K—8 (p+1) bits—>| K—8(p+1) bits 


In these formats, dn is the ASCII representation of a decimal digit, S indicates the sign, and p 
indicates the precision, which must be greater than zero and less than 32. The plus sign is 
represented by the ASCII character + (hexadecimal 2B) the minus sign by the ASCII character 
— (hexadecimal 2D). 


The format of an unpacked decimal integer with the sign indicated by a trailing overpunch is 
as follows: 


lel jl 


The rightmost character in storage depends on the least significant digit of the integer and on 
whether the integer is positive or negative as shown below. 


Least Significant Digit 


QO |] 2 3 4 5 6 7F 8 9 
Positive ASCII graphic 1 A B C D E F G@ H I 
Hexadecimal code] 7B 42 43 44 45 46 47 48 49 
Negative|ASCII graphic 
Hexadecimal code} 7D 


4) 
J 
4A 


L | 
48 4C 4D 4E 4F 50 51 52 


|~—8p bits—— 
Packed Decimal integers 


The prefix letter and the range of values for signed and unsigned packed decimal integers are 
shown in Table 2-4. 


TABLE 2-4. PREFIX LETTER AND RANGE OF VALUES FOR SIGNED AND UNSIGNED 
PACKED DECIMAL INTEGERS. 


Prefix Letter Type Range 
P Signed —10°<n<+10 
U Unsigned O<n<+10 


The formats of packed decimal integers are as follows: 
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ed Format for packed signed decimal integers 


4 (p+1) bits—>| 
| dt} a2]... | Format. for packed unsigned decimal integers 


Examples of Decimal Integers 


The source language and the associated stored value for the various types of decimal integers 
are given in the following examples: 


Stored Value 


Source language (hexadecimal) 
P'125’ 125B 

—P'99436’ 9943 6DO0 
U'125’ 1250 

U'99436’ 9943 6000 
L‘125’ 2B31 3235 
—L'99436’ 2D39 3934 3336 
T°125’ 3132 352B 
—T°99436’ 3939 3433 362D 
0°125’ 3132 4530 
—0'99436’ 3939 3433 4F30 
O*20’ 327B 

—O*'20° 327D 

N‘125’ ) 3132 3530 


FIXED-POINT CONSTANTS 


A fixed-point constant is written as a decimal number with an associated scale factor and an 
optional precision field. When the resultant value is stored in memory, a fixed-point constant 
appears as a signed integer with negative values in two’s complement form. The scale factor (s) 
gives the location of the implied binary point in the stored constant. A positive scale factor 
means that the binary point is situated s bits to the left of the rightmost bit stored in memory. A 
negative scale factor means that the binary point is situated s bits to the right of the rightmost 
bit stored in memory. Thus, the true value of a fixed point binary number may be calculated by 
multiplying its integer representation by 2°°. 

The two formats for writing fixed-point constants are, as follows: 


Format 1 
“Hine PPL 
of B s SINGLE PRECISION 


[i]t 
Format 2 


"] ing B (: "| .) SINGLE OR DOUBLE 


[i]. —| / PRECISION 


Specifies the sign of the constant. The + sign may be omitted. 


~_— 


cE: 
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Specifies the integer part of the decimal number. 
Specifies the fractional part of the decimal number. 
Specifies the precision of the constant,0<r<31. 


[=]s 
Specifies the value and sign of the scale factor. 


Format 1 has an implied precision of 15 bits. The value of a fixed-point constant must fall 


within the range 
2-s<|R|<2*s 
where R is the value of the decimal number. 


Fixed-point constants are stored as aligned signed two’s complement binary numbers; that is 
they occupy one word if they are single precision and two words if they are double precision. The 
assumed binary point is located s bits to the left of the rightmost bit if the scale factor is positive, 


and —s bits to the right of the rightmost bit when the scale factor is negative. 


The following examples illustrate how to specify fixed-point constants and show the 


hexadecimal representations of the resultant values in memory. 


Source Language Stored Value 
2.5B4 0028 
2.5B8 0280 
655386B-15 0002 
65536B-7 0200 
— 2.5B8 FD80 
—65536B-15 FFFE 
262144B(20,0) 0004 0000 
262144B(20,—7) 0000 0800 
262144B(15,—7) 0800 
— 262144B(20,0) FFFC 0000 
— 262144B(20,—7) FFFF F800 


FLOATING-POINT CONSTANTS 


The assembly language provides a convenient method with which you can write a decimal 
number and have the Assembler convert it into floating-point format. (See Section 1 for a 


description of floating-point data.) 
There are three formats for floating-point constants: 


Format 1 


[i] f 


Format 2 


‘| | oa E i | c SHORT PRECISION 


Format 3 


Biraae 
D c DOUBLE PRECISION 


Specifies the sign of the constant. The + sign may be omitted if desired. 


ELEMENTS OF 
ASSEMBLY LANGUAGE 2-10 


CBO7 


Specifies the integer part of a decimal number. 


f 

Specifies the fractional part of a decimal number. 
0 

Indicates that a short-precision floating-point representation is desired. 
D 


Indicates that a double-precision floating-point representation is desired. 
[+]e 
Expresses the power of 10 by which the coded decimal number should be multiplied to 
produce the value wanted. The + sign may be omitted if desired. 
Note: 


If the decimal point is omitted, the number is assumed to be an integer. 


The absolute value of a floating-point constant must be greater than or equal to 2°™ (approxi- 
mately 5.3976 X 10”) less than 2” (approximately 7.2370 X 10%). 


Nomalization 


Floating-point constants are stored as normalized hexadecimal floating-point numbers witha 
7-bit excess 64 power-of-16 characteristic and a 25-bit or 57-bit signed magnitude mantissa. A 
normalized floating-point number has a nonzero high-order hexadecimal fraction digit. If one or 
more high-order fraction digits are zero, the number is said to be unnormalized. Normalization 
consists of shifting the fraction left until the high-order hexadecimal digit is nonzero and 
reducing the characteristic by the number of hexadecimal digits shifted. 


Examples 


The following examples illustrate how to specify floating-point constants and show the 
hexadecimal representations of the resultant values in memory. You can determine sign, 
characteristic, and mantissa of the resulting floating-point numbers by dividing the 
hexadecimal representations into parts according to the patterns described in Section 1. 


Source Language Stored Value 
—.5 8180 0000 
5 8250 0000 


0.5E12 9474 6A52 

0.5D12 9474 6A52 8800 0000 

—0.5D12 9574 6A52 8800 0000 
6.665039063E — 2 8011 1000 
—6.665039063E — 2 8111 1000 


Expressions are combinations of symbolic names and constants used as operands within 
Assembler control and assembly language (machine) instructions. Expressions can represent 
locations (internal, external, or common), values, and addresses. Components of an expression 
can be joined by various functions and arithmetic operators, as follows: 


Arithmetic Operator Meaning 


+ Addition (or Unary +) 
< Subtraction (or Unary —) 
* Multiplication 
/ Division 
Boolean Function Meaning 
AND Conjunction of argument1 and argument2 | 
OR Inclusive disjunction of argument1l and argument2 
XOR Exclusive disjunction of argument1 and argument2 
NOT Negation of argument1 
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Shift Function _ Meaning 


ALS Arithmetic left shift of argument1 
by argumentz2 bits 
ARS Arithmetic right shift of argument1 
by argument2 bits 
LES Logical left shift of argument1 
by argumentz2 bits 
LRS Logical right shift of argument1 
by argument2 bits 
Arithmetic Function Meaning 
“MOD Remainder after division when argument1 
is divided by argument2 
MAX The value of the algebraically 
largest argument 
MIN The value of the algebraically 


smallest argument 


General Format of a Function: 
function-name (argument 1, argument 2) 


NOTE: The Boolean NOT function has only one argument. 


When a value is operated upon by an arithmetic operator or function or by an arithmetic shift 
function the value is considered to be a 16-bit signed (two’s complement) binary integer. Whena 
value is operated upon by a Boolean or logical shift function the value is considered to be a 16-bit 
bit string. You must ensure that the results of a Boolean or shift operation will be meaningful 
when subsequently interpreted as an integer value by the Assembler. The results of each 
computation must be within the allowable range of integer dimensionless values. The range is 
from -32768 to +32767. 


The shift functions must satisfy the conditions specified below or else the function will not be 
performed and the operation will be flagged as an error condition. 


ALS 0<argument2<15 
ARS 0 <argument2<15 
LLS and LRS O<xargument2<15 


Argument2 in the arithmetic function MOD must not equal 0. If this condition is not satisfied, 
an error condition is flagged and the function is performed as if argument2 is equal 1. 


The arguments in all arithmetic operations and functions must be binary integers. 


To use a function within an expression you write the function name followed by its operands, 
enclosed in parentheses and separated by a comma; e.g., AND (TAG1,TAG2). 


Below are examples of functions: 


VALI EQU X‘100’ 
VAL2 EQU X‘10F 
VAL3 EQU 3 
LOC1 EQU | $ (at location 200 hexadecimal) 
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AND 
DC <LOC1+AND(VALI1,VAL2) 
resolves to address 300 hexadecimal 


| OR 

( DC <LOC1+OR(VALI,VAL2) 

resolves to address 30F hexadecimal 
XOR 

DC <LOC1+XOR(VALI1,VAL2) 

resolves to address 20F hexadecimal 
NOT 

VAL4 EQU NOT(VAL2) 

resolves to value FEFO hexadecimal 
ALS 

VAL5 EQU ALS(VAL1,VAL3) 

resolves to value 800 hexadecimal 
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Section 3 


Programming 
Considerations 


Before writing an assembly language source program, you should take into consideration 
both features and constraints inherent in the design of the Assembler and the system. This 
section describes the considerations that should be made, as well as the various rules that must 
be followed, when coding your source program. These include: 


e Rules of formatting your source language statements 
e Ordering of statements in an assembly language program 
e Rules governing the calling of system services and external procedures 


e Utility programs that supplement assembly language source programs 


ASSEMBLY LANGUAGE SOURCE STATEMENT FORMATS 


As mentioned in Section 2, the assembly language consists of Assembler controlling 
statements and assembly language (operational) instructions. Assembly language source code 
must be submitted to the Assembler in a recognizable format so that it can be interpreted 
accurately. Therefore, when coding assembly language source statements, you must conform to 
the following formatting conventions: 


Column 1 
A A A 
labelA opcode 7 Aoperand 2 ,operand operand] ..| [Acomments] 
linenumA A : : 


linenum-labelA 


The semicolon (;) indicates to the Assembler that the next operand is contained in the next 
sequential source line (i.e., the continuation statement), which has the following format: 


Column 1 
4 


[linenum][A operand operand - a) [Acomments] 
A 


In addition to comments being included on individual assembly language source 
statements, comment statements, which have the following format, can be included in the 
source language program. 


Column 1 | 


* 
/ 

@ 
linenum* 
linenum/ 
linenum# 
linenum@ 


comments 


7/79 
PROGRAMMING CONSIDERATIONS 3-1 CB07-01B 


The asterisk (*) indicates that the comment line is to be included in the listing wherever it is 
included in the source language program. The slash (/) indicates that the Assembler is to cause 
the printer to skip to the top of the next page of the listing before printing the comment. The 
pound sign (#) and the at-sign (@) designate macro processor comment lines. Upon request the 
macro processor generates comment lines that begin with the at-sign (@). These lines are macro 
control statements without errors. The macro processor unconditionally generates comment 
lines that begin with the pound sign (#). These lines are statements that generate macro 
processing errors. Printing of lines can be overridden by the inclusion of an NLST Assembler 
control statement in the source code (see Section 4). 


In the above formats, label is any user-specified tag, linenum is any user-specified line 
number, linenum-label indicates a line number followed by a label with no intervening spaces, 
opcode and operand indicate the required assembly language fields described in Sections 4 
through 7, and blank (A) indicates that one or more blanks or horizontal tab characters must be 
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coded. Any number of blanks and/or horizontal tab characters can follow a comma (,). A line 
number is an unsigned decimal integer of any length. Line numbers are ignored by the 
Assembler. 


Except for the order in which information must be supplied, the source language format is a 
free-form. However, it is suggested that you establish a fixed format for coding source 


statements (e.g., always starting op codes in the eleventh position and operands in the twenty- 
first) so that you can read your listing more easily. 


ORDER OF STATEMENTS IN SOURCE PROGRAM 


With the following exceptions, Assembler control statements can be entered in any order: 
1. The TITLE statement must be the first statement in the source program. 
2. The END statement must be the last statement in the source program. 


CALLING SYSTEM SERVICES 


System services (e.g., the Task Manager) can be requested through the use of monitor service 
calls and macro calls. For information concerning requests for system services see the System 
Services Macro Calls manual. 


CALLING EXTERNAL PROCEDURES 


Procedures that are assembled separately from the invoking procedure are designated 
external procedures. 


The individual elements of data passed to an external procedure are known asarguments. The 
external procedure interprets these arguments as parameters; to the external procedure, the 
order of the parameters is the same as the order of the arguments passed from the invoking 
procedure. 


External procedures can be requested by coding request sequences such as the following: 


LAB $B7,arglist 
LNJ $B5,<entry 


In the above sequence, ‘entry’ is the external label of the appropriate entry point of the called 
(external) procedure, and ‘arglist’ is the argument list to be passed to the called (external) 
procedure. 


Alternatively, you could use a request such as the following: 
CALL entry,argl,arg2,... 


This request is similar to the preceding sequence except that the CALL Assembler control 
statement automatically generates the argument list, loads its address into B7, and sets the 
return address in B5. As a result, when the external procedure completes its work, control is 
returned to the next sequential instruction or statement in the calling program. 


ALTERNATE METHOD OF HANDLING 
INPUT/OUTPUT AND FILE MANIPULATION 


Input/output and file manipulation can be accomplished by writing Assembler routines or by 
using monitor service requests. Details concerning monitor service requests are contained in 
the System Service Macro Calls manual. 


ASSEMBLER 


The Assembler processes source statements written in assembly language, translates the 
statements into object code, and produces a listing of the source program together with its 
associated assembly information. 


The Assembler accepts arguments that allow you to control its operation in various ways. 
Detailed information about the Assembler and its arguments can be found in the Commands 
manual. 
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a 
{ ‘ f 


IF 


IF 


Instruction: 


Conditional skip 


Source Language Format: 


OD 
P 
flabelJAIF < [N] < N A int-val-expression, label 
Z 
EV 


Description: 

If the specified condition is met, the Assembler skips (reads but does not process) subsequent 
statements until the label is encountered; otherwise, the next sequential instruction is proc- 
essed. (0 is neither positive nor negative.) 


The opcode is interpreted as follows: 
IFP 

Skip to label if int-val-expression is positive (i.e. > 0). 
IFNP 

Skip to label if int-val-expression is not positive (i.e. < 0). 
IFN 

Skip to label if int-val-expression is negative'(i.e. < 0). 
IFNN 

Skip to label if int-val-expression is not negative (i.e. = 0). 
IFZ 

Skip to label if int-val-expression is zero. 


IFNZ 
Skip to label if int-val-expression is not zero. 


IFOD 
Skip to label if int-val-expression is odd. 


IFEV 
Skip to label if int-val-expression is even. 


The operands have the following meanings: 

int-val-expression 
Internal value expression (see “Expressions” in Section 2); forward references are not 
permitted. 


label 
Label (see “Labels” in Section 2) identifying the next statement or instruction to be 
processed by the Assembler if the condition is met. 
If a label is specified, it is not entered in the Assembler’s symbol table; as a result, it can be 
referred to only by a preceding IF statement. 
Example: 
IFNZ AND($SW,Z’4000’), SKIPIT 


External Switch 1 is checked. If it is set the Assembler skips the subsequent statements 
until the label SKIPIT is encountered. If External Switch 1 is not set, the Assembler goes to 
the next lie of assembly code. This is an example of varying an assembly procedure without 
altering the assembly language source program. 
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LCOMM 


LCOMM 

Instruction: 

Define local common block 

Source Language Format: 
labelALCOMMaAint-val-exp 

Description: | 


Provides a way for a block of data local to a program to be allocated not by the Assembler, but by 
the Linker using standard linking procedures for allocating common blocks. The data allocated 
by use of the LCOMM statement is not shared. 


The label field and op2rands have the following meanings 


label 
The name of the common area. 


NOTE: LCOMM does not allow a temporary label to be specified. 


int-val-exp 
Specifies the size (in words) of the common area. The Linker (see the Program Execution and 
Checkout manual) assigns all common blocks with the same name to the same memory area 
regardless of the memory location in the source program at which they are defined (i.e., the 
LCOMM statement does not alter the Assembler’s location counter). In the case of a local 
common block, the Linker removes the name of the local common block from its symbol 
table after it has linked the program which defined the local common block. 


int-val-exp is an internal value expression (see Section 1), and must be defined prior to the 
occurrence of this LCOMM statement. It must not contain a forward reference. Elements in 
a common block can be referenced by the name of the common block plus the element’s 
displacement within the block. 
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ae 


PTRAY 


6, PTRAY 
( | Instruction: 
- Create pointer array 
Source Language Format: 
[label]JAPTRA YA location-exp1| ,location-exp2| . . . 
Description: 


Creates an array of pointers. The address of a memory word is referred to as a pointer. Pointers 
may occur at the level of machine language both as direct addresses and as indirect addresses. 


The Assembler generates the object unit code as if the statement were transformed into the 
following DC statement. 


[label]JADCA < location-exp1 [,<location-exp2].. . 


If the Assembler is invoked with the SLIC argument, it will also identify the object unit text 
: resulting from the PTRAY statement as being a pointer array. This is necessary so that in 
loading a SLIC program, the Loader will compress addresses if executing in SAF mode. 
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RESV 


RESV 


Instruction: 


Reserve main memory space 


Source Language Format: 
(label JARES VAint-val-expal[,int-val-expb] 


Description: 


Reserves space in main memory for use by the bound unit as work or storage space. | 


The label field and operands have the following meanings: 


label 
If specified, the first word of the reserved area is given that name. 


int-val-expa 
This is an internal value expression (see Section 2) that specifies the size (in words) of the 
reserved area, and must be = 0. It must not contain a forward reference. 

int-val-expb 
If specified, it is an internal value expression (see Section 2) specifying the initial value to 
which each word in the reserved area is initialized when the bound unit is loaded. If this 
operand is not specified, the contents of the reserved area are undefined. 
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ASSEMBLED INSTRUCTION 
= (ADD $R2,*$B5.$R 1) 
( 


LOCATION 2022 


MEMORY LOCATION 101A 
; | LOCATION 1000 (EFFECTIVE ADDRESS) 
Z a ar \_ 
+ 1A WORDS 

R1 ‘ 
i 
.- - 001A - oalieieaeteaelientineedaedieedl ent oatt 

( Figure 5-12. Indexed Indirect B-Relative Addressing 


ASSEMBLED INSTRUCTION 
(SUB $R6,$B5.XVAL2A) 


eg 


MEMORY 


LOCATION 200A 
LOCATION 2000 (EFFECTIVE ADDRESS) 


——— — —e + AWORDS 


( a Figure 5-13. Direct B-Relative Plus Displacement Addressing 
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INDIRECT B-RELATIVE PLUS DISPLACEMENT ADDRESSING 


This form of addressing effectively adds a displacement value to the contents of the specified 
base register. Then, the effective address is the contents of the location whose address is derived 
through this preceding operation. 

In the following example of this form of addressing, EXP10 is an internal value expression 
equated to 0010, $B4 contains the address 30FF, location 310F contains the address 10FE, 
location 10FE contains the value 400D, and $k7 contains the value 1013. 


Example: 
ADD $R7,*$B4.EXP10 


In this example, the displacement value 0010 is added to the contents of $B4 (i.e., 0010 + 
30FF), producing the address 310F. Then, applying the indirection operator, the contents of 
the location 310F (i.e., 1OFE) are used as a memory address. The value found at location 10FE 
G.e., 400D) is added to the contents of $R7. The result (5020) is stored in $R7. 


Figure 5-14 illustrates how this form of addressing generates an effective address when stored 
in memory. | 


ASSEMBLED INSTRUCTION 
(ADD $R7,*$B4.EXP10) 


a 


LOCATION 10FE 
(EFFECTIVE ADDRESS) 


MEMORY 


Figure 5-14. Indirect B-Relative Plus Displacement Addressing 


DIRECT B6-RELATIVE PLUS LOCAL COMMON BLOCK PLUS DISPLACEMENT ADDRESSING 


In this form of addressing, the effective address is computed by adding a specified value to the 
contents of base register $B6. This addressing form assumes that $B6 contains the address of the 
combined $LCOMW local common blocks. For information on the loading of $B6, see Appendix 
M. The value that is added to the contents of $B6 is assumed to be an offset value (before 
adjustment by the Linker) into the local common block, $LCOMW. 


Example: 
TEN EQU 10 
$LCOMW LCOMM 300 
ORG $LCOMW+10 
DC 100 


7 | 1/79 
ASSEMBLY LANGUAGE INSTRUCTIONS 5-18 : CBO07-01B 


/ 


In this example, suppose that the constant 100 which is contained in the eleventh word of the 
local common block, $LCOMW,, is to be loaded into data register $R1. If at execution time, $B6 
contains the address of the combined $LCOMW local common blocks, then either of the 
; following instructions will accomplish the desired result. 
( i LDR  $R1,$B6.$LCOMW+TEN 
_ LDR $R1,$B6.$LCOMW+10 
Figure 5-15 illustrates how this form of addressing generates an effective address when stored 


in memory. 
ASSEMBLED INSTRUCTION NOTE: THIS EXAMPLE ASSUMES THAT THE 
(LDR $R1, $B6. $LCOMW + 10) COMPILE UNIT CONTAINING THIS 
pea ey EXAMPLE IS LINKED AS THE FIRST 
COMPILE UNIT IN A GIVEN OVERLAY; 
Kf 9848 | 008 | THE LINKER ACTUALLY INCREMENTS 
THE DISPLACEMENT (000A IN THIS 


EXAMPLE) BY THE SUM OF THE SIZES 
OF THE $LCOMW LOCAL COMMON 
BLOCKS IN THOSE COMPILE UNITS 
THAT ARE LINKED PRIOR TO THE 
CONCERNED COMPILE UNIT WITHIN 
ANY GIVEN OVERLAY. 


WORD 0 (i.e., FIRST WORD) 


OF LOCAL COMMON BLOCK 
$LCOMW EFFECTIVE ADDRESS 


ne ee, 
ee a eae 


—~—--- + + + ~~ + - > +10WORDS 
Figure 5-15. Direct B6-Relative Plus Local Common Block Plus Displacement Addressing 


INDIRECT B6 - 
RELATIVE PLUS LOCAL COMMON BLOCK PLUS DISPLACEMENT ADDRESSING 


ue In this form of addressing, the effective address is specified by the contents of the location 
( computed by effectively adding a value to the contents of base register $B6. This addressing form 
; assumes that $B6 contains the address of the combined $LCOMW local common blocks. The 
value that is added to the contents of $B6 is assumed to be an offset value (before adjustment by 

the Linker) into the local common block, $LCOMW. 


B6 


POINTER TO 
WORD 0 OF 
$LCOMW 


MEMORY 


Example: 
$LCOMW LCOMM 300 
ORG $LCOMW 
DC <CONST 
ORG $LCOMW+20 
CONST DC 100 


In this example, assume that the constant 100 which is contained in the 21st word of the local 
common block, $LCOMW, is to be loaded into data register $R1, and that the address of the 
constant is known to be in word zero of the local common block. If at execution time, $B6 
contains the address of the local common block, then the following instruction will accomplish 
the desired result. 


LDR = $R1,* $B6.,LCOMW 


Figure 5-16 illustrates how this form of addressing generates an effective address when stored 
in memory. 
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MEMORY 


ASSEMBLED INSTRUCTION 
(LDR $R1, *$B6. $LCOMW) NOTE: THIS EXAMPLE ASSUMES THAT THE 


COMPILE UNIT CONTAINING THIS 


POINTER TO 
WORD 0 OF 
S$LCOMW 


EXAMPLE IS LINKED AS THE FIRST 
COMPILE UNIT IN A GIVEN OVERLAY; 
THE LINKER ACTUALLY INCREMENTS 
THE DISPLACEMENT (0000 IN THIS 
EXAMPLE) BY THE SUM OF THE SIZES 
OF THE $LCOMW LOCAL COMMON 
BLOCKS IN THOSE COMPILE UNITS 
THAT ARE LINKED PRIOR TO THE 
CONCERNED COMPILE UNIT WITHIN 
ANY GIVEN OVERLAY. 


WORD 0 (FIRST WORD) EFFECTIVE 
OF $LCOMW ADDRESS 


POINTER TO CONST, 
WHICH IS $SLCOMW + 20 Cons 0064 
(i.e.,<.$ + 20) 


0 WORDS “INDIRECTION” 


Figure 5-16. Indirect B6-Relative Plus Local Common Block Plus Displacement Addressing 
B-RELATIVE PUSH ADDRESSING 


This form of B-relative addressing causes the contents of the specified base register to be 
decremented before the effective address is formed. The new address in the register is the 
effective address of the location or data to be used in the operation. The B register is decremented 


by: 


One for all instructions accessing one-bit, one-byte, or one-word operands. 
Two for all instructions accessing double-word operands. 
Four for all instructions accessing quadruple-word operands. 


One for SAF configurations or two for LAF configurations for the LDB, STB, SWB, CMB, 
and CMN instructions. 


NOTE: 


LAB is an instruction accessing a one-word operand. 


In the following example, $R5 contains the value 30FF,$B5 contains the address 4011, and 
memory location 4010 contains the value 0001. 


Example: 


ADD $R5,—$B5 


In this example, the contents of location derived by subtracting one from the address con- 
tained in $B5 are added to the contents of $R5, and the result (3100) is stored in $R5. a next 
time $B5 is used, it will contain the address 4010. 


Figure 5-17 illustrates how the sample instruction described above is stored in memory and 
how it derives the effective address of the data to be used in the operation. 


ASSEMBLED INSTRUCTIONS 
(ADD Ab aaa -$B5) 


\ foass] —f LOCATION 4010 
pete peninns ADDRESS) 


tier 
MEMORY 


BEFORE: ae 


Figure 5-17. B-Relative Push Addressing 
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ACQ 


ASSEMBLY LANGUAGE INSTRUCTIONS 


The remainder of this section lists (alphabetically) and describes the assembly language 
instructions for the Central Processing Unit (CPU). Assembly language instructions for the 
Commercial Processor and the Scientific Instruction Processor (SIP) are given in Sections 6 and 
7 respectively. The description of each instruction includes the name, type, format, and explana- 
tion of operands. 

When an operand specifies a symbolic name, constant, or expression (other than an address 
expression), refer to Section 2 for a detailed description of those elements. Address expressions 
are defined in this section under “Addressing Techniques.” Before using the following 
instructions you should fully understand the assembly language elements described in Section 2 
and in this section. 

Although not shown in the source language formats, all assembly language instructions can 
be labeled. 


ACQ 
Instruction: 


Acquire stack space 


Type: 
GE 


Source Language Format: 
$Bn 
AACQA 4 X‘n’ ( ,$Rn 
n 
Description: 
This stack instruction acquires an additional frame, of the size specified by the contents of $Rn, 
from the currently available stack space. $Bn is set to point to this newly acquired frame (lower 
memory address, see Figure K-1). 
If the size specified by Rn is such that the currently available stack space is exceeded, a trap to 
trap vector 10 occurs. 
Stack instructions are double-word instructions with the following characteristics. 
e A common first word. 
e Bits 0 through 8 and bit 12 of the second word contain zeros. 
If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 
Bits 9 through 11 of the ACQ instruction specify the register $Rn bits 13 through 15 specify 
register $Bn. 
This instruction is executable only on Models 40 and 50. 
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ADD 


ADD 

Instruction: 

Add Contents to R-register 

Type: 

DO 

Source Language Format: 
| $Rn } 

AADDA < X‘n’ > , address-expression 

in 

Description: 


Adds the contents of the location or R-register identified in the address expression to the 
contents of the R-register specified in the first operand. The result is saved in the first operand 
R-register. 

The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


oon register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


The contents of the I-register are affected as follows: 


e Ifthe result is more than 2!5 —1 (32767) or less than —215 (—32768), the OV-bit is set to 1: 
otherwise, it is set to 0. 


e If, during the summation, a carry occurs, the C-bit is set to 1; otherwise, it is set to 0. 
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] 
i] 
( fh 
r / 
Mole 


— 


ADV 


ADV 

Instruction: 

Add value to R-register 
Type: 

SI 

Source Language Format: 


$Rn internal-value-expression 
AADVA ae L=] bene pattie pera ee 


Description: 


Adds the 8-bit value (with sign extended) specified in the second operand to the contents of the 
R-register identified in this operand. The result is saved in R-register. 


The contents of the I-register are affected as follows: 


e Ifthe result is more than 2°—1 (32767), or less than — 2 (—32768), the OV-bit is set to 1; 
otherwise, it is set to 0. 


e If, during the summation, a carry occurs, the C-bit is set to 1; otherwise, it is set to 0. 
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AID 


AID 

Instruction: 

Add integer double 

Type: 

SO 

Source Language Format: 


AAIDAaddress-expression 
Description: 


Adds the value of the double-word integer specified by the address expression to the value in the 


register pair $R6, $R7. The result is saved in $R6 and $R7, with the most significant part in $R6 
and the least significant part in $R7. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

= $Bn 

=$Sn registers addressing 


Short displacement addressing 
Specialized addressing 


If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (1.e., four bytes or 32 bits). In all 
cases, the immediate operand must be a constant that has not been assigned a symbolic name. 


If=$Rn is used, only = $R3 (adds the contents of R2 and R3 into R6 and R7 respectively), =$R5 
(adds the contents of R4 and R5 into R6 and R7, respectively), or =$R7 (doubles the value 
contained in R6 and R7) may be used. 


If a carry occurs, the C-bit of the I-register is set to 1, else it is set to 0. 


If overflow occurs, the OV-bit if the I-register is set to 1, else it is set to 0. 


This instruction is executable only on Models 40 and 50. 
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a 


ENT 


ENT 

Instruction: 

Enter 

Type: 

SO 

Source Language Format: 


immediate-memory-address 

B-relative-addressing 
ee P-relative-addressing 

interrupt-vector-addressing 


Description: 


Jumps to the memory location specified by the operand; also, sets the P-bit of the ring field in the 
S-register to 0 (i.e., sets the bit to indicate the unprivileged state). 


If the J-bit in the M1-register contains a binary 1, the trace procedure is entered via trap vector 
2. Upon completion, or if the J-bit contains a binary 0, execution commences at the specified 
location. 
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HLT 


HLT 

Instruction: 

Halt 

Type: 

GE 

Source Language Format: 
AHLT 


- Description: | 


ge OS 
i 


Stops program execution. HLT state is indicated on the control panel. All interrupts are 
honored. 


The P-bit of the S-register must be set to 1, or the ring field of the S-register must be set to 1x, 

whichever is appropriate; i.e., the central processor must be in the privileged state for this 

instruction to be executed. If not, the unprivileged use of a privileged operation results in a trap - 
to trap vector 13. 


A halt instruction on a user level may prevent a lower priority user level from completing a 
Monitor service operation. The Monitor may be interrupted in a way that causes a system 
interlock. If user level halts are used during program development, the level specified should be 
the lowest priority in the system. | 


Tannen 
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HL aa 


LDI 


LDI 


Instruction: 

Load double-word integer 
Type: 

SO 

Source Language Format: 


ALDIAaddress-expression 
Description: 


Loads the contents of the location specified by the address expression into register R6 and the 
contents of the next location into register R7. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


= $Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). In all 
cases, the immediate operand must be a constant that has not been assigned a symbolic name. 


If =$Rn is used, only =$R3 (loads the contents of R2 and R3 into R6 and R7, respectively) or 
=$R5 (loads the contents of R4 and R5 into R6 and R7, respectively) and =$R7 may be used. 
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LDR 


LDR 

Instruction: 

Load R-register 

Type: 

DO 

Source Language Format: 
$Rn 

ALDRA { X‘n’? ,address-expression 

n 

Description: 


Loads the contents of the location or R-register identified in the address expression into the 
R-register identified in the first operand. | 
The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn | register addressing 

=$Sn 

Short displacement addressing 

Specialized addressing 
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ida oo 


LDT 


Instruction: 


Load stack address register 
Type: 
GE 
Source Language Format: 
{X 
ALDTA ¢ X‘n’ 
n 


Description: 


Loads the T register with the address contained in $Bn (see Figure K-1). 


Stack instructions are double-word instructions with the following characteristics: 


e A common first word. 


e Bits 0 through 8 and bit 12 of the second word contain zeros. 


LDT 


If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 
Register $Bn is specified in bits 13 through 15 of the second word of the LDT instruction. 


Stack instructions can be executed only on Models 40 and 50. 
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LDV 


LDV 

Instruction: 

Load value 

Type: 

SI 

Source Language Format: 


$Rn} 
ALDVA | X‘n’ | , [=]internal-value-expression 
aes | 
Description: 


Loads the 8-bit value identified in the second operand into the right half-word of the R-register 
specified in the first operand. The contents of bit 8 are extended through the left half-word of the 
R-register. | 


Except for the string constant form of the second operand, all values are assumed to be numeric. 
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RLQ 


RLQ 

Instruction: 

Relinquish stack space 

Type: 

GE 

Source Language Format: 
ARLQA$Bn 

Description: 


This stack instruction releases the most recently acquired stack frame. If the stack is emptied by 
this instruction, the result is a trap to trap vector 9. If the stack is not emptied, the current 
length of the stack is adjusted and the base register specified, $Bn (bits 13 through 15 of the 
second word of the instruction, see Figure K-1), is set to point to the new top frame. 


Stack instructions are double-word instructions with the following characteristics: 
e A common first word. 
e Bits 0 through 8 and bit 12 of the second word contain zeros. 
If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 


Stack instructions can be executed only on Models 40 and 50. 
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RSTR 


RSTR pe 


Instruction: a. 


Restore context 

Type: 

SO 

Source Language Format: 


immediate-memory-address 
-B-relative-address 
P-relative-address 
interrupt-vector-addressing 


external-value-label 
internal-value-expression 
single-precision-fixed-point-constant 


ARSTRA 


Description: 


Restores the registers specified in the second operand mask starting from the location specified 
in the address expression. 


The second operand is a mask that specifies which registers are to be restored. If the mask is all 
zeros, the contents of R1 are used as the mask. 


Depending on which bits in the specified mask are set to 1, the registers that can be restored are 
V2) 43 “P45 


as follows: 
0 Wi 2g 3 a ae > ane | 8 9 10 


This mask should be the same as the one used to save the registers (see the SAVE instruction). 


Bits 
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SDI 


SDI 


Instruction: 


Store Double word integer 


Type: 
SO 


Source Language Format: 


ASDIAaddress-expression 
Description: 


Stores the contents of register R6 into the location specified by the address expression and the 
contents of register R7 into the next location. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 

=$Bn 

=$Rn} register addressing 

=$Sn 
If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 
If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 


fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). In all 
cases, the immediate operand must be a constant that has not been assigned a symbolic name. 


Note: 
=$R3, =$R5, and =$R7 are permitted and refer to register pairs $R2, $R3; $R4, $R5, 
and $R6, $R7, respectively. 


Short displacement addressing 
Specialized addressing 
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SID 


SID 
Instruction: = 
Subtract integer double | 

Type: 

SO 


Source Language Format: 


ASIDAaddress-expression 
Description: 


Subtracts the value of the double-word integer specified by the address expression from the 
value in the register pair $R6, $R7. The result is saved in $R6 and $R7, with the most significant 2 
part in $R6 and the least significant part in $R7. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


=$Bn| register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 


If the address expression specifies memory addressing with indexing, the index register is 
aligned to count double-words relative to the word specified. 


If Immediate Operand Addressing is specified, the immediate operand may only use a binary 
integer constant (which is sign extended to 32 bits by the Assembler), a double precision 
fixed-point constant, or a string constant of exactly two words (i.e., four bytes or 32 bits). In all 
cases, the immediate operand must be a constant that has not been assigned a symbolic name. 


If =$Rn is used, only =$R3 (subtracts the contents of R2 and R3 from R6 and R7 respectively), or a 
$R5 (subtracts the contents of R4 and R5d from R6 and R7 respectively), or =$R7 (clears R6 and 

R7) may be used. 

If a borrow is required during the subtraction, the C-bit of the I-register is set to 0; otherwise it is 

set to 1. 3 

If overflow occurs, the OV-bit of the I-register is set to 1, otherwise it is set to 0. 

This instruction is executable only on Models 40 and 50. 
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STS 


STS 
Instructions: 
Store S-register 
Type: 
SO 
Source Language Format: 
ASTSAaddress-expression 
Description: 
Stores the contents of the system status (s) register in the location or R-register identified in the 
address expression. 


The address expression can take any of the forms described earlier in this section under 
“Addressing Techniques,” except for the following: 


zh ig | register addressing 
=$Sn 

Short displacement addressing 
Specialized addressing 
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STT 
Instruction: 
Store Stack Address Register 
Type: 
GE 
Source Language Format: 
ASTT 

Description: 
This stack instruction moves the address contained in the T register to register $B7. 
Stack instructions are double-word instructions with the following characteristics: 

e A common first word. 

e Bits 0 through 8 and bit 12 of the second word contain zeros. 
If bits 0 through 8 and bit 12 of the second word are not zero, the result is a trap to trap vector 16. 


Stack instructions can be executed only on Models 40 and 50. 
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ALR 
ALR 


a Instruction: 
( Alphanumeric move 
Type: 
Character string 


Source Language Format: 


DESCA (description) DESCA (description 
AALRA 
int-val-expression 4 | int-val-expression | 


Description: 


: The character string is moved from the address specified by the first operand (sending field) to 
the address specified by the second operand. If the length of the receiving field is zero, the TR-bit 
(truncation bit) of the Commercial Processor indicator register is set to 1, and the instruction is 

: aborted. Trap 28, truncation, may then be generated as described previously under “Commer- 
cial Processor Traps.” 


If the length of the sending field is zero, the receiving field is filled or not as specified by the 
second data descriptor. 


If the value of the byte length specified by the first data descriptor is zero, the length is contained 
in the right byte of register R4 and can be from 0 through 255 bytes. If the value of the byte 
length specified in the first data descriptor is not zero, that value, which can be from 1 through 
31, is the length. 


If the value of the byte length specified by the second data descriptor is zero, register R5 contains 
the fill character (in the left byte) and the length (in the right byte). When escape to register R5 
occurs, the length can be from 1 through 255 characters. If the value ofthe byte length specified 
in the second data descriptor is not zero, that value is the length, and the fill character is an 
ASCII blank (20 hexadecimal). In this case, the length can be from 1 through 31 bytes. 
Applicable Traps: 

Trap 23 Reference to unavailable resource 

Trap 24 Bus or memory error 

Trap 26 Illegal specification 


Trap 28 Truncation 


The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe length of the first operand string is greater than the length of the second operand 
string, the TR-bit is set to 1; otherwise, it is set to 0. 
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AME 
AME 


Instruction: 

Alphanumeric move and edit 
Type: 

Edit 
Source Language Format: 


DESCA(description)} | DESCA(description) DESCA (description) 
AAMEA > , 
int-val-expression int-val-expression int-val-expression 


Description: 


The character string in the sending field specified by the first data descriptor (DD1) is edited in 
accordance with the micro operations in the field specified by, the third data descriptor (DD3), 
and moved to the receiving field specified by the second data descriptor (DD2). 


The number of edited characters stored in the receiving field can be either more or less than 
those in the sending field. The receiving field may have more characters when micro operations 
specify one or more characters are to be inserted. The receiving field may have less characters 
when a micro operation specifies that one or more characters of the sending field are to be 
skipped. 


The instruction terminates normally when the receiving field is filled. Normal termination 
occurs even though the sending field or the string of micro operations have not been exhausted. 


An illegal specification trap (Trap 26) is generated if either the sending field or the string of 
micro operations are exhausted before the receiving field is filled. 


Execution details are as follows: 


e The effective address developed from a data descriptor points to the leftmost character of 
the operand. 


e All operations take place from left to right. 


e The valid length of the sending field, the receiving field, and the string of micro operations 
ranges from 1 through 255. Lengths from 32 through 255 are specified via escape to an R 
register. (See Appendix H.) 


e During execution of the instruction, the sending field count indicates the current number 
of characters remaining to be processed. The count is decremented every time a character 
is moved out or skipped over. 


e During execution of the instruction, the receiving field count indicates the current number 
of positions that remain to be filled. The count is decremented every time a character is 
moved into the receiving field. 


e The Edit Insertion Table (EIT) is always initialized when the edit instruction is initiated. 
-e The edit flags are always initialized when the edit instruction is initiated. 
Applicable Traps: 


Reference to unavaitable resource 


‘Prap 23 

Trap 24 Bus or memory error > 

Trap 26 Illegal Specification 
Conditions causing trap: 


_e The sending field or the string of micro operations is exhausted before the receiving 
field is filled. 


e The length of the sending field, or the receiving field, or the string of micro operations 
is: Zero. 
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DRS 


DRS 
Instruction: 


Decimal right shift 

Type: 

Shift 

Source Language Format: 


DESCP(description) 
ADRSA 4 DESCU (description) [ [ int-val-expression] LR [OUNDED | if ] 
int-val-expression / | 


Description: 


The decimal value specified by the first operand is shifted right. The vacated digit positions are 
zero filled. The second operand, if present, specifies the distance (number of digits shifted) and 
must be an integer from 0 through 31. 


When the second operand is present, the assembler: 
e Sets shift control word 1 (SCW1) to 0178 (hexadecimal). 
e Sets bit 0 of SCW2 to 1 (i.e., right shift). 
e Loads the value specified by the second operand in bits 3 through 7 of SCW2. 
e Sets bit 8 of SCW2 to 1, if the third operand is present (i.e., rounding). 
e Clears bit 8 of SCW2 to 0, if the third operand is absent (i.e., no rounding). 


When the second and third operands are omitted, the assembler generates the shift control 
words as it does for the DSH instruction when the second operand is omitted. The shift direction, 
the distance, and the rounding control must then be obtained from register R5. For an 
explanation of shift control words, see Decimal Shift instruction DSH. 


Applicable Traps: 


The traps that may be generated during execution of this instruction are the same as those for 
the DSH instruction. 


Note that only one shift instruction, decimal shift (DSH), is available in the hardware. The 
decimal left shift (DLS) and the decimal right shift (DRS) instruction are provided by the 
Assembler for the programmer’s convenience. 
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DSB 

DSB 

Instruction: 

Decimal subtract 

Type: 

Decimal arithmetic 
Source Language Format: 


DESCP(description) DESCP (description) 
ADSBA 4 DESCU(description)? , 4DESCU(description) 7 
int-val-expression int-val-expression 


Description: 


Subtracts the decimal value (the subtrahend) at the address specified by the first operand from 
the decimal value (the minuend) at the address specified by the second operand and stores the 
result (the difference) at the address specified by the second operand. 


Applicable Traps: 
Trap 23 Reference to unavailable resource 
Trap 24 Bus or memory error 
Trap 26 Illegal specification 
Trap 27 Illegal Character 
Trap 29 Overflow 


The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of significant digits in the difference is greater than the number of digit 
positions available in the receiving field, the OV-bit is set to 1; otherwise, it is set to 0. 


e Ifthe difference is ngative and the receiving field is described as unsigned, the SF-bit is set 
to 1; otherwise, it is set to 0. 


e If the difference is less than zero, the L-bit is set to 1; otherwise, it is set to 0. 


e Ifthe difference is greater than zero, the G-bit is set to 1; otherwise, it is set to 0. 


COMMERCIAL INSTRUCTIONS 6-54- CBO07 


MAT 
MAT 
Instruction: 
Alphanumeric move and translate 
Type: 
Character string 


Source Language Format: 


{ DESCA(description) ) { DESCA (description) 
AMATA ’ 


: DESCA (description) | 


int-val-expression int-val-expression } (int-val-expression 


Description: 


The character string in the sending field (specified by the first data descriptor) is translated and 
moved to the receiving field (specified by the second data descriptor). The third data descriptor 
specifies a 256-byte translation table. Each character in the sending field is used as a displace- 
ment from the base of the table and the corresponding character from the table is stored in the 
receiving field. 


Ifthe byte length specified by the first data descriptor is zero, the length is contained in the right 
byte of register R4 and can be from 0 through 255 bytes. If the byte length specified in the first 
data descriptor is not zero, that value, which can be from 1 through 31, is the length. Ifthe length 
of the sending field specified by register R4 is zero, the receiving field is filled or not filled as 
specified by the second data descriptor. Fill characters, if specified, are ASCII blanks and are not 
translated. 


If the byte length specified in the second data descriptor is not zero, that value, which can be from 
1 through 31, is the length. If the byte length specified by the second data descriptor is zero, the 
length is contained in register R5 and can be from 0 through 255 bytes. If the length of the 
receiving field specified by register R5 is zero, the instruction is aborted and the truncation bit 
(TR bit) of the Commercial Processor indicator register is set to 1. Trap 28 (truncation) may then 
be generated as previously described under “Commercial Processor Traps.” 


The length field of the third data descriptor is ignored by the hardware. 
The contents of the Commercial Processor indicator register are affected as follows: 


e Ifthe number of characters in the sending field is greater than the number of character 
positions in the receiving field, the TR-bit is set to 1; otherwise, it is set to 0. 


Example: 
IN DC = 700020409’ 
TR DC =‘abcdefg$.!”’ 
OUT RESV 4, ‘ 
MAT DESCACIN,0,4,NO_FILL); 


DESCA(OUT,0,4,NO_FILL); 
DESCA(TR,0,11,NO_FILL) 


After execution of the MAT instruction the receiving field OUT will contain the following 
string: ace! 
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Alphanumeric search 


Type: 
Character string 
Source Language Format: 
oats | DESCA(description) | DESCA(description)) { DESCA(description) } 
ASRCHA 34. , _ ee i cee eat a ® es eer eke ee: | 
int-val-expression int-val-expression | ’ | int-val-expression 
Description: 
The character string or array of character strings defined by the third data descriptor (DD3) is 
searched to see if it contains any of the search arguments (one or more) in the search list defined 
by the first data descriptor (DD1). If a match is found, the G and L bits of the Commercial 
Processor indicator register are cleared to zero, and the displacement and search argument 
number are loaded into the receiving field defined by the second data descriptor (DD2). (This 
simulator does not support the Alphanumeric Search (SRCH) and Alphanumeric Verify (VRFY) 
opcodes.) The receiving field must be four bytes long and word aligned; otherwise the results are 
unspecified. The displacement is the distance in bytes between the origin of the string (or array) 
to be searched and the position at which the first match occurs. The search argument number 
designates the one that caused the match. The first argument in the list is identified as 0, the 
second as 1, etc. The format of the receiving field is shown below. 


0 15 0 15 


isearch argument number | displacement 


If a match is not found, the G-bit of the Commercial Processor indicator register is cleared to 
zero, the L-bit is set to one, and the receiving field is not changed. 


The search argument list can contain one or more search arguments each consisting of one or 
more characters. If multiple arguments are specified, each must be the same length. 


If the length field of DD1 is not equal to zero, the search argument list contains only one search 
argument whose length (1 to 31 bytes) is specified by the length field. 


If the length field of DD1 is equal to zero, the search argument list is specified by register R4. The 
format of register R4 is shown below. 


0 7 8 15 


| search argument length} search list length 


If the search argument length is equal to the search list length, the search list consists of only 
one argument. 


If the ratio of the search list length to the search argument length is an integer, that integer 
designates the number of search arguments. 

if the ratio of the search list length to the search argument length is not an integer, the ratio is 
truncated to the integer value and that integer designates the number of search arguments. 
The character string (or array) to be searched is specified by DD3. If the length field of DD3 is not 
equal to zero, the operand is a character string whose length (1 through 31) is specified by the 


length field. If the length field is equal to zero, the operand to be searched is specified by register 
R6. The format of register R6 is shown below. 


0 7 8 15 


operand element length operand length | 
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SRCH 


The results of a search instruction for this array and various search arguments are as follows. 


( | Commercial Processor 
ee Indicator Register DD2 Field 
SA L-Bit G-Bit SA Number Displacement 
ca 0 0 0 08 
a 0 0 0 00 
mjo 0 0 0 10 
mjpo 1 0 unchanged 
acbec 0 0 0 04 
eacba 1 0 unchanged 
bac 1 0 unchanged 
cade 0 0 0 08 
“ Example 4: Search Array — Multiple Search Arguments 


The search list defined by DD1 contains multiple search arguments. Each search argument can 
consist of one or more characters but all search arguments must be the same length. The search 
argument length (SAL) and the search list length (SLL) is specified by register R4. 


If a match is found, the search argument number and the displacement are stored in the 
receiving field specified by DD2. If a match is not found, DD2 is not changed. 


Assume that DD3 defines the following array for which register R6 specifies the length of each 
element (OEL) as 4 and the operand length (OL) as 24. 


Displacement String 


00 abdf 
04 acbe 
08 cade 
oa OC defg 
( 10 mjop 
14 eacb 


The results of a search instruction for this array and various search arguments are as follows. 
Commercial Processor 


Indicator Register DD2 Field 
SAL SLL SA L-Bit G-Bit SA Number Displacement 
3. «6 acb,acd 0 0 0 04 
1 3 c,a,d 0 1 00 
4 8 defg,abcd 0 0 0 OC 
2 6 ad,ea,mj 0 0 2 10 
3 9 aab,abb,eac 0 0 2 14 
5 10 abdfb,mjope 0 0 1 10 
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VRFY 


VRFY 

| Instruction _— 
Alphanumeric verify Ly 
Type: 


Character string 


Source Language Format: 


DESCA (description) { DESC A (description) | hegre tag 


AVRFYA j. 
int-val-expression int-val-expression int-val-expression 


Description: 


The character string or array of character strings defined by the third data descriptor (DD3) is 
examined. If at least one character of the string (or element of the array) does not match any one 
of the verify arguments, the G-bit of the Commercial Processor indicator register is cleared to 
zero, the L-bit is set to one, and the receiving field specified by the second data descriptor (DD2) 
is loaded with the displacement. (This simulator does not support the Alphanumeric Search - 
(SRCH) and Alphanumeric Verify (VRFY) opcodes.) The displacement is the distance in bytes 
between the origin of the string (or array) and the place where the first mismatch is found. The 
format of the receiving field is shown below. 


Q | 15 


displacement 


Tf each of the characters of the string (or elements of the array) is equal to any one of the verify 
arguments, the G- and L-bits of the CIP indicator register are cleared to zero and the receiving 
field is not changed. 


If the length field of DD1 is not equal to zero, the verify argument list contains only one search 


argument whose length (1 through 31 bytes) is specified by the length field. 
If the length field of DD1 is equal to zero, the verify argument list is specified by register R4. The 
format of register R4 is shown below. | 
0 7 8 15 
verify argument length verify list length 
Ifthe verify argument length is equal to the verify list length, the verify list consists of only one ‘ 
argument. 
If the ratio of the verify list length to the verify argument length is an integer, that integer 
designates the number of verify arguments. ; 
If the ratio of the verify list length to the verify argument length is not an integer, the ratio is 
truncated to the integer value and that integer designates the number of verify arguments. 
The character string (or array) to be verified is specified by DD3. If the length field of DD3 is not 
equal to zero, the operand is a character string whose length (1 through 31) is specified by the 
length field. Ifthe length field is equal to zero, the operand to be searched is specified by register 
R6. The format of register R6 is shown below. 
0 /8 15 
operand element length operand length c ; 
| Ni 7 
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Section 8 


Macro Facility 


The Macro Preprocessor is a program development tool that provides a convenient method for 
including in a source module sequences of statements that are specified in a macro routine. 


A macro routine is a block of source code that is written only once and can be included multiple 
times within a given source program. A single statement, known as a macro call, is specified in 
the source program each time the sequence of statements is to be included. A source program 
containing one or more macro calls is called an unexpanded source program. Macro routines can 
be at the beginning of a source program or in a macro library; those occurring with a source 
program are called inline macro routines. 


The Macro Preprocessor produces an expanded source program which is used as input to the 
Assembler. The expanded source program may contain an error flag for each nonfatal error. 
Each statement that contains a nonfatal error flag appears in the expanded source module as a 
comment statement with the appropriate error. (Nonfatal error flags are described in Appendix 
F.) If a fatal error occurs, processing terminates, an error message is issued to the error-out 
stream, and control returns to the Command Processor. (Error messages issued by the Macro 
Preprocessor are described in the Systems Messages manual.) The pound sign (#) and the at sign 
(@) designate macro processor comment lines. Upon request the macro processor generates 
comment lines that begin with the at sign (@). These lines are macro control statements without 
errors. The macro processor unconditionally generates comment lines that begin with the pound 
sign (#). These lines are statements with macro processing errors contained in them. 


NOTE: 
Honeywell provides a library of macro routines that support MLCP programming. 
(See the MLCP Programmer’s Reference Manual.) 


ORDER OF STATEMENTS WITHIN A SOURCE PROGRAM 


Statements within a source program must be in the order listed below: 
1. TITLE Assembler control statement. 


2. LIBM macro control statements and/or macro routines delimited by MAC and ENDM 
macro control statements. 
(Optional) LIST or NLST Assembler control statement 
(Optional) comment statements 
Note: 
LIBM statements, macro routines, comment statements, and a LIST or NLST 
statement can be intermixed. 


3. Statements that constitute the body of the source module; includes macro calls. 


4, END Assembler control statement. Identifies the end of the assembly language program. 
Statements subsequent to this statement will be ignored by the Assembler. If this 
statement is missing, both the Assembler and the Macro Preprocessor will generate an 
END statement. 


Macro control statements and macro calls are described in this section. Assembler control 
statements are described in Section 4. 


MACRO ROUTINES 


A macro routine can be either generalized or specialized. A generalized macro routine causes 
a fixed expansion in the source module. A specialized macro routine permits specified values to 
be included in the expanded source module. 
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MAC WITHOUT PARAMETERS 


The following information is described below. 
e Creating a macro routine 

e Specializing a macro routine 

e Including protection operators 


e Situating a macro routine 


CREATING A MACRO ROUTINE 


A macro routine must be preceded by a MAC macro control statement and followed by an 
ENDM macro control statement. 


MAC MACRO CONTROL STATEMENT, WITHOUT PARAMETERS 


The MAC statement assigns a name to a macro routine; it must immediately precede every 
macro routine. MAC must be the last entry on the source line, or it must be immediately 
followed by a comma and an optional comment. 


Format: 
macro-nameAMAC [ ,| comment | | 
macro-name 


Name of the macro routine; must be a valid symbolic name. To include the macro routine 
within a source module, specify the macro name in a macro call. 


NOTE: 


A macro routine can be specialized by including macro parameters in the MAC 
statement. (See “MAC Macro Control Statement, Including Parameters” later in 
this section.) 


CONTENTS OF MACRO ROUTINE 
A macro routine can include: 
e Macro control statements, excluding MAC and ENDM 
e Macro functions 
e Assembler control statements, excluding END 
e Assembly language statements 


Macro control statements and macro functions are described in this section. Assembler control 
statements and assembly language statements are described in Sections 4 and 5 through 7, 
respectively. 
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MAC WITH PARAMETERS 


Expanded source module: 


( 7 TITLE EXMPL 
LDV $R1,=5 Macro call replaced by contents of macro 
routine named SAMPLE 


LDR $R2,='6,' 


PROTECTION OPERATORS 


Protection operators are brackets; they enclose one or more characters that are not to be 
interpreted by the Macro Preprocessor. Protection operators can be included in macro routines 
and/or in statements that constitute the body of a source program. 


- NOTE: 
Brackets illustrated in each command’s Format are not protection operators; they 
enclose optional characters. 
Example: 


This example illustrates an unexpanded source module, which includes protection operators, 
and the resulting expanded source module. 


Unexpanded source module: 


TITLE EXMPL 
SAMPLE MAC P7=3 Designates beginning of macro routine and 

assigns value to parameter P7 

NEWA [?] P7 Substitution operator will not be inter- 
preted by Macro Preprocessor, so no value 

cn will be substituted 
( NEWB ?P7 Reference to P7 will be replaced with its 

value 

ENDM Designates end of macro routine 

[SAMP LE] Not interpreted as macro call because name 

; of macro routine is enclosed within protec- 
tion operators 

SAMPLE Macro call; in the expanded source module 


will be replaced by contents of macro rou- 
tine named SAMPLE 


- Expanded source module: 


TITLE EXMPL 
SAMPLE 


NEWA 2P7 | 
Contents of macro routine named SAMPLE 
NEWB 3 


Protection operators cannot extend over operand or argument delimiters; to protect adjacent 
operands or arguments, enclose each one individually in brackets. 
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Example 1: 
FOOA[AB],[CD] 
The above macro call FOO designates that parameter P1 equals [AB] and parameter P2 equals 


[CD]. -_ 
Example 2: ae 
FOOA[AB,CD] 


The above macro call FOO is not equivalent to the macro call illustrated in example 1. The 
macro call in example 2 specifies that parameter P1 equals the character string consisting of the 
following three characters: [AB, and parameter P2 equals the character string consisting of the 
following three characters: CD]. 

If any part of a label or operation code is protected, the entire label or operation code is 
protected. 
Example: 

LAB[ELJALD[R]A$R1,= 100 

The above statement is considered to have no label and no operation code. 

Protection operators do not appear in expanded source modules unless the operators are 
embedded in other protection operators. - 


Example 1: 
NEWA[?]P7 
The above statement appears in the expanded source module as NEWA?P7. 


Example 2: 
DC ‘A[BC[DEF]GH]’ 


The above statement appears in the expanded source module as DCA’ABC[DEF]GHI’. Only 
the outermost protection operators are removed, unless the expanded source module is then 
reprocessed by the Macro Preprocessor. 


Protected comment statements appear in the expanded source module with the protection 
operators removed. If protected comment statements appear in a macro routine, they are 
substituted in the expanded source module as described previously. Unprotected comment 
statements which appear in a macro routine are considered to document the macro routine 
itself; thus they are not substituted into the expanded source module. 


Example: 


ABC MAC 
HLT 

*COMNT1 

[*ICOMNT2 
ENDM 


In the above example COMNT72 is considered a macro routine comment and will appear in the 
expanded source module as 
*COMNT2 : 


COMNT1 is not considered a macro routine comment and will not appear in the expanded source 
module. 


SITUATING MACRO ROUTINES 


Macro routines can be in the source module in which they are requested by macro call(s) 
and/or in macro libraries on a mass storage volume. A macro library is a directory whose files are 
macro routines. Each file must be a single macro routine that is referenced in a macro call by its 
file name. Its file name must be identical to the label of its MAC statement. 


_ All macro routines within a source module must be at the beginning of the module. (See 
“Order of Statements Within a Source Module” earlier in this section.) 
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RQ 
REQUOTE MACRO FUNCTION 


The requote macro function replaces each apostrophe in an alphanumeric character string 
with two adjacent apostrophes, and encloses the entire resultant string within single apostro- 
phes. All characters in the original character string that are not apostrophes remain unchanged 
and appear in the resultant string. 


Format: 
?RQ(arg) 
arg 
An alphanumeric character string to be requoted. (See “Designating Alphanumeric 
Values” in this section.) 
Example 1: 
?RQ(ABC) yields 
‘ABC’ 
Example 2: 
?RQCWHO)’) yields 
CW HO” 
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First Second 
Hexadecimal Hexadecimal Hexadecimal | Hexadecimal | 
Digit Digit 


Otaddsyl 
8+addsyl 
O+addsyl 
8taddsyl 
Ot+addsyl 
8taddsyl 
O+addsyl 
8taddsyl 
O+addsyl 
S8taddsyl 
O+addsyl 
8t+addsyl 


9-F 


O+addsy] 
8t+addsyl 
O+addsyl 
8t+addsyl 


SM 
SDV 
8taddsyl 
8taddsyl 
O+addsyl 


8taddsyl 
Ot+addsyl 
8taddsyl 


ne 
oe) 
oe) 
af 
> 

Qu. 
a) 
wn 

) 

ep) 


TABLE A-2. ADDRESS SYLLABLES FOR CPU & SIP INSTRUCTIONS 


: 001 $Bn.$R1 | *$Bn.$R1 
, On *< location.$R3 *$Bn.$R3 


111 4 $IV. value $Bk.-$R3 | $Bq.t$R3 
j =Value 


NOTE: An address syllable can be represented as mmmirrr, which are the last seven bits in the word; n can be any number 
between 1 and 7 and is equal to rrr for rrr#0; k is a number within the range 1 through 3 and is equal to rrr for 


~ rr = 1, 2,3; and q is a number within the range | through 3 and is equal to rrr-4 for rrr = 5,6, 7. For more in- 
( | formation about these address expressions, see “Addressing Techniques” in Section 5. 


x 
= 
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VALID ADDRESS EXPRESSIONS 


Table A-3 lists all of the valid address expressions and shows graphically how each derives the 
effective address of the data to be used in the operation. : 


The various types of symbolic names, constants, and expressions (other than address eS 
expressions) are described in detail in Section 2. . y 


TABLE A-3. SUMMARY OF VALID FORMS OF ADDRESS EXPRESSIONS FOR CPU 
| AND SIP INSTRUCTIONS 


Address 


Addressing Expression Generation of 
Technique Form Effective Address 
~ Register Rn = EA 
Addressing Bn = EA 
on = EA, 


Immediate | Direct f locexpression : 
Memory < "4 
Addressing -) templabel location = EA 


Indirect locexpression 
T<— + 
‘"t templabel location = EA 
Indexed locex pression l 
Direct =a ‘"f location + R = EA 
-) templabel 3 


Indexed 


Indirect an 


ee ee Ct te a at 


locexpression l 
Jocation+R 92? = EA 
3 


| 
+ $R 42 
~§ templabel 3 


Immediate Address of current address gree 


Addressing a 
: a 


extvallabel 


P-Relative intlocexpression 
Addressing | Direct (‘t 
-) templabel yinternal location = EA 
intlocexpression 
* ‘" 


-) templabel internal location 
B-Relative $Bn Bn = EA 


Addressing | Indirect *$Bn Bn, = location ) 
location, = EA 


Indexed ] l . 
Direct $Bn.$R 42 Bn, + R <2)= EA 


EA 


Bn = location 
wen 


Indexed 


Indirect location + R 


Direct + eo B = 
n+ value = EA 
sxe _ 
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TABLE A-3 (CONT). SUMMARY OF VALID FORMS OF ADDRESS EXPRESSIONS FOR CPU 


Address 
Addressing Expression Generation of 
Technique Form Effective Address 
Be Relative Caer 4 Bn + value = location 
Addressing | Displacement *$Bn. \extvallabel location, = EA 
(Cont.) 


B6 direct + $B6.SLCOMW + Bo + value = EA 


Displacement intvalexpression 


B6 indirect + *$B6.$6LCOMW + B6 + value = location 
Displacement intvalexpression location = EA 


Indexed Pop 


Indexed Push 


Short intlocexpression 
Displacement ae 
-) templabel location = EA 
neva eniesion Word following the word(s) 
| oe containing op code + first 
Special extvallabel operand address syllable = EA 


Interrupt Vector IV + value = EA 


a | 


g intvalexpression 
‘| extvallabel 


NOTE: The symbols used in this table have the following meanings: 


-—~- Contents of... : Indirect memory addressing 
EA -_ Effective Address < Immediate memory addressing 
< - Replaces the element pointed at > Short displacement addressing 
locexpression — location expression (any type) >= Specified Addressing 
templabel as temporary label Component separator 
stringconstant - string constant (indexing and displacement) 


intvalexpression — internal value expression 
extvallabel - external value label 
intlocexpression — internal location expression 


All other notations represent standard usage as defined in the preface of this manual or 
required Assembler-specific symbols. 
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% 


.— = 
j \ 
4 ‘ 
ot wee” : 


The following sample programs illustrate many of the aspects of the assembly language 


described in this manual. 


CHKNML —SAF 
000001 
000002 
000003 
000004 
000005 
000006 
000007 
000008 
000009 0100 
000010 

000011 0000 A433 FFEF 
000012 0002 BBA 
000015 6003 BbCS FFEC 
000014 0005 9873 
000015 0006 1002 
000016 0007 0981 QU7C 
000017 0009 9843 0UU7 
000018 

000019 0008 CBCO 0079 
000020 v000D D380 0000 
000021 v00F 1981 O06F 
0000e2 

000023 0011 ICl1E 
000024 0012 eC00 
000025 0013 b&BLCO 0081 
000026 0015 CBCC O06F 
CO00027 0017 0380 0000 
000028 0019 1981 0066 
000029 0018 3CFF 
000030 O001C 3E01 
0v0031 0010 8B97G 0000 
000032 O01F 0301 OO4E 
000033 60e1 CCbO 0000 
000034 0023 CBC4Y O0IC 
000035 0025 F830 0000 
000036 O027 F944 00038 
000037 0029 0973 
000038 002A EbBCO 007A 
000039 Oo02C D830 0090 
000040 O02E FSCO 002? 
000041 0030 EBCO 0077 
000042 0032 0804 
000043 0033 F3C0 C0ee 
000044 0035 CBC4 6001 
000045 0037 ECU 0073 
000046 00359 D804 
000047 OC3SA FSCO 001K 
000048 003C C8E4 0001 
000049 QO03E EBCO OU6F 
000050 0040 0804 
000051 0041 F3CO 0014 
000052 0043 CBC4 0001 
000053 0045 EBCU 006B 
000054 0047 D&04 
000055 0048 FSCO 000D 
000056 

000057 OQOO4A iIC1E 
000058 0048 eco 
000059 O04C BBCO 0057 
000060 O04E CBCO 0036 


SAMPLE ASSEMBLY 
LANGUAGE PROGRAM 


* PPOGRAM COMPARES TEST RESULTS OF 


Appendix C 


Sample Assembly 
Language Program 


be OA CHKNML 


1977/11/21 0940:05.6 ASSEMBLER-0100-11/09/1223 GCOS6 MOD0400-S100-—11/17/0634 PAGE 0001 


TEST MUDULES WHOSE ADDRESSES ARE 


* STUREU IN SCUMM TO THE EXPECTED TEST RESULTS AS DESCRIBED IN TABLOC 


XVAL. TSTMAX 
xLOC TAHLLOC 
XLOC ZIUSOL 
XLOC ZLOSWR 
XLOC Z10SCO 
comnts x'1n0! 
* GET FILENAME AND CHANNEL NO 
STRT Lik Ske,SE3.917 
LAB S$H5,3RS5.bR2 
Law %O5,5b5.2.°7°0 
LOR $R1L,+4K3 
Cty dRi-e 
BNE ERNEST 
LOW SR1,563.7 
* GREN LIST FILE 
LAB SB4U,LSTOCK 
Xx LNJ $B5,<ZIGSOL 
BNE Z SRL,EROPF I 
* wkITe HEADER MSG 
Liv SRI,K'LTE!T 
LDV SRO,x'0! 
LAt bKR3, vHUF OI] 
LAK $Hh4,LSTOCB 
x LhiJ $B5,<ZIT0SWR 
BNE/ Ski,FRHDR ° 
LDV pR3,~xX' 1! 
TLOOP ADDY mRo,X' 1! 
x CMR SR3,=TSTMAX 
BG ENUTST 
kK LD $384, <ECOMM, OkS 
LAB €B4,3KR4.x'1C! 
Xx LOR $k7,<TABLCC. SRS 
CMk $R7,3B4,x'3! 
RE >TLOOP 
LAR bBo, ALFA 
K LOR $RS,<8COMML SPS 
LNJ 5B7,D.UMPH:D 
LAtb BO, VBUF OR 
LOR PRS, dB4 
Ltd 9B7,DUMPHD 
Lat $B4,5B4.xX'1' 
La& Stim, WHUF eC 
LDR PRO, O04 
LN SE7,DUMPHWD 
LAB $B4,$RB4,X'1' 
Lab SHO, WRUF 2D 
LOR $RS,%b64 
LivJd $H7.,0UMPWD 
LAb SBa, FU X' 1! 
LAB sho, BUF CE 
LOR $RS,SB4 
LNJ %B7,DUMPKD 
* WRITE VALUES 
LOV SRI,X'LE' 
LOV pRe,x'd! 
Lab HS, Wi BUF 20 
LAB $B4,LST7T0CB 


Figure C-1. 


Listing of CHKNML Program 


SET us tO LIST ELLE: AT 
SET 63 TU FILENAME 


NO LIST FILE ATTACHED 
SET R1 TO CHANNEL NO, 


OPEN ROUTINE 


MSG LENGTH 
MSG ADDRESS 
WRITE ROUTINE 


CHECKED ALL TEST RESULTS ? 


CREATE STATUS BLOCK PTR 
GET EXPECTED VALUE 
COMPARE TO ACTUAL STATWD 
TEST OK = CHECK NEXT TEST 


CONVERT TEST ADDR TO ASCII 


CONVERT SYML VALUE TU ASCII 
CONVERT TEST NUM TO ASCII 
CONVERT SYMV VALUE TO ASCII 
CONVERT STATUS WORD TO ASCII 


MSG LENGTH 


MSG ADURESS 
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CHKNML —SAF 1977/11/21 0940 : 05.6 ASSEMBLER—0100—1 1/09/1223 GCOS6 MD0400—S100—1 1/17/0634 PAGE 0002 I 


COO006tL 0050 O38 OuduU X LiuJ SB5.<2Z1TUSWR WRITE ROUTINE 
000062 0052 1981 ov2t BNE Z SRI,ERVAL . 
006063 0054 &3C0 FFC7 , JMP TLOUP 
000064 * ROUTINE ACCEPTS A VALUE IN RS AND PUTS ITS ASCII EQUIVALENT foo 
000065 * IN THE TwO WURDS POINTED TO BY be a 
000066 0056 4CFC DIEMPWD LOv SPu,e-x'a! SET COUNTER 
000067 0057 CF4n voud T STR SRO, +H#C 
000068 0059 7000 LOv SR7,X'Q! 
000069 O0SA u4CCo dA LOV bkau,x'ot 
000076 0058 5084 DOL BRS, 4 
000071 005C 4ES50 ADV SRU,X' 30! 
000072 005d C94Q 0060 | CMR $RU,+SF 
000073 OOSF 0380 7 BLE >+5E 
000074 O060 GEDT ARDY SRK Cet 
000075 dO061 Fu4seg SE OR SR7,2ERY 
000076 0062 SALY FFFS J INC +$L 
000077 0064 0600 T BCT >+5|) 
000078 0065 7088 DOL DR7,8 
000079 Q066 UFFS4 T B >-SA 
000080 0067 EF4e 0000 $D STR SRo,SBO.X'0! 
000081 0069 FFdo Y001 STR OK7,S5H6.xX' 1! 
000082 0068 8387 JMP S47 RETURN TO CALLER 
000083 Qader o000 $C CC Z'ut 
000064 dQ06D 0039 $F DC Z2'0039! + 
000085 * WRITE END TEST 
000086 U06E iCva ENDTST LOV SRIL,X'A! MSG LENGTH 
0000867 vO6F eC00 LUV dbke,xX'0' 
000088 0070 BECO 0043 Lats 43, wBUF OS MSG ADLRESS 
000089 vut72 CBCO 001e LAB $B4,LSTOCE > 
000090 0074, £380 0000 x LNJ $B5,<ZI0SWR WRITE ROUTINE 
000091 0076 1981 VNB BNE Z SR1,EREND 
000092 ® ACES Ee BES trick 
000093 0078 CBCO OGOC LAB SB4,LSfOCB 
000094 Q07A 0360 0000 X LNG 915,<Z1T0SCG CLUSE ROUTINE 
000095 0O007C 1941 0006 BNE Z SRL,ERCLS 
000096 O07E 0000 HT 
000097 OO7F 0000 EROPEN HLT 
000098 0080 0000 ERHDR HLT 
000VU99 006} 0000 ERVAL HL] 
000100 0082 G9000 EREND HLT 
000101 0083 0000 ERCLS HLI 
000102 0084 0000 EPNLST HLT 
000103 0085 9000 LSTDCts RESY 16,0 
000104 0095 4120 WBUF CI OC "A tloc tsym tnum tval tswa! 
0096 7T46C 
0097 oF b3 
0098 2020 pte 
0099 7473 a * 
009A 796D : 
009B 2020 ee 
0U9C 7T46E 
009D 7560 
009E 2020 
009SF 7476 
0040 616C 
C0AL 2020 
O02 7473 
0045 7764 
000105 o0AG 4120 WRUF 2U DC ‘A ! 
000106 Q0A45 eved WRUFCA DC : : 
CHKNML PAGE 0003 
0046 2020 
00A7 2020 “ 
000107 O0AB 2020 WRUF ets DC : : 
00A9 2020 
0O0AA 2020 
000108 Q0AB 2020 WBUF 2C NC ; : 
OOAC 2020 ad 
COAD eGey 
000109 OCAE eb2y wRUF 2D DC : : 
QQOAF 2020 
00B0 2020 
O0Giic O08i e020 WOUF EE oe : : 
00B2 2020 
0063 2020 
000111 O0R4 UdleY wRUFOS DC "A end test! 
VOBS o656E 
00B6 6420 
0067 7465 
0068 7374 
000112 0069 END CHKANMEL 


0000 ERR COUNT 


Figure C-1 (cont). Listing of CHKNML Program 
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ASSEMBLY LANGUAGE PROGRAM HARDWARE INDEPENDENCE 


Ifan assembly language program written for a Series 6/20 or 6/30 is to be used on a Series 6/40 
or 6/50, the program must be written to be program independent of the hardware model. The 
additional features in the larger Series 6/40 and 6/50 that must be considered are instruction 
prefetching that affects self-modifying procedures and long address form (LAF). The GCOS 6 
MOD 400 Linker produces SAF, LAF, or SAF-LAF Independent Code (SLIC) bound units. 


SELF-MODIFYING PROCEDURES 


Use of a self-modifying procedure should be carefully considered for two reasons: (1) a 
self-modifying procedure cannot be made reentrant, and (2) the instruction, as modified, might 
not be executed because of the instruction prefetching feature of the Series 6/40 and 6/50. With 
instruction prefetching, an arbitrary number of words are prefetched in parallel with the 
execution of the current instruction. The prefetch buffer is emptied only when a transfer of 
control occurs. If an instruction is stored in a word that previously was prefetched, the prefetch 
buffer is not cleared and the prefetched instruction will be executed as it was prior to modification. 


However, if a self-modifying procedure must be used, the program must contain code to 
remove the prefetched instruction from the prefetch buffer after modification is complete but 
before the modified code is executed. This can be done by executing an unconditional branch of 
the form: 


B $+2 FLUSH THE PREFETCH 


( WRITING SOURCE PROGRAMS THAT CAN BE EXECUTED IN BOTH 
SAF AND LAF CONFIGURATIONS 


There are two methods for writing a source program so that it can be executed in both SAF and 
LAF configurations: SAF/LAF independence by assembly, which produces a program that is 
assembled differently for each type of configuration, and SAF/LAF independence by loading, 
which produces a program that is assembled and linked in the same way but is loaded differ- 
ently. For the second method, SAF/LAF Independent Code (SLIC) is used to create the source 
program. 


A SLIC program consists entirely of Assembler control statements, assembly instructions, 
and macro calls, all of which are described in the Assembly Language Reference manual. These 
items must be selected and combined according to the rules and restrictions described in the 
following text. SLIC is the code that results from this procedure. 


As shown by Figure L-1, a program can run on a SAF and LAF configuration, if all the 
‘ compilation units are SLIC compilation units and linking is done by a GCOS 6 MOD 400 Linker. 
When requested, the Assembler produces SLIC compilation units. However, the Assembler does 
not check that the code conform to the SLIC rules and restrictions. If the code does not conform, 
the results of the program are unpredictable. 


The valid ways in which SAF and SLIC compilation units and LAF and SLIC compilation 
units can be linked into bound units are shown in Figure L-2. 


The following system service macro calls should not be used in a program written in SAF/LAF 
independent code (SLIC): 


$CRB S$PRBLK $TRB S$MGCRB $MGCRT 
$CRBD $RBD $TRBD $MGIRB $MGIRT 
$IORB $SRB $WAITL $MGRRB $MGRRT 
$IORBD $SRBD S$WLIST 
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SOURCE ASSEMBLER GCOS 6 MOD 400 


SAF 
PROGRAM (—SAF] LINKER | EeObeEG CONFIGURATION 
| (~SAF) | 
COMPILATION BOUND 
UNITS 
ASSEMBLER | ER 
(—LAF) ene, CONFIGURATION 
a, SAF/LAF Independence at Assembly 
BOUND 
UNITS 
SOURCE ASSEMBLER GCOS 6 MOD 400 SAF 
eee (-SLIC) LINKER POADER CONFIGURATION 
COMPLIATION LOAD 
UNITS UNITS 
LOADER ane 


CONFIGURATION 


b. SAF/LAF Independence at Loading 


Figure L-1. Methods of Achieving SAF/LAF Independence 


SAF COMPILATION 


SOURCE ASSEMBLER UNITS 
PROGRAM (—SAF) 


SOURCE ASSEMBLER 


GCOS 6 MOD 400 


| SAF 


PROGRAM {—SLIC) 


LINKER LOADER 


| CONFIGURATION | 


BOUND LOAD 
UNITS UNITS 


SLIC COMPILATION 
UNITS 
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ASSEMBLER 
(--SLIC) 


SOURCE 
PROGRAM 


LAF 
CONFIGURATION 


LOADER 


GCOS 6 
LINKER 


BOUND LOAD 
UNITS UNITS 


SOURCE 
PROGRAM 


ASSEMBLER 
(—LAF) 
LAF CONFIGURATION 


| | | | UNITS 


SLIC ONLY COMPILATION UNITS 


SOURCE ASSEMBLER SAF OR LAF 


PROGRAM (—SLIC) LOADER CONFIGURATION 


Figure L-2. Valid Combinations of Compilation Units for Linking 
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SAF/LAF INDEPENDENCE BY ASSEMBLY 


An assembly language program assembled to execute under a SAF system can be converted to 
execute under a LAF system by simply reassembling the program for execution on the LAF 
system. Reassembly is usually possible provided that the following rules are observed when the 
program 1s written. 


1. The program must be written so it will assemble without errors in either configuration; 
e.g., a short displacement branch must satisfy the conditons —64<d<1 or 2<d<63 words 
on the LAF configuration as well as on the SAF configuration. 


bo 


All memory locations should be referenced by their symbolic names. The assembly 
language label $AF can also be used in expressions to correctly reference the desired 
memory location; however, the $AF reference should be used with care since its use 
requires a good understanding of how the hardware operates. 


3. Offsets to elements of a data structure containing pointers must be defined symbolically. 
When the data structure actually exists in another program, the assembly language label 
SAF can be used in an equate statement to provide the proper template. 


4. All constants used in index computation to reference arrays of structures containing 
pointers must be symbolically defined. 
For example: if the span of an array element is “a” words plus “b” addresses, then the 
constant should be defined by the expression a+b*$AF. This constant can then be used to 
compute an index register value which is in turn used in a LAB instruction to set a base 
register to the beginning of the desired occurrence of the array element. 


5. All fields that are to contain pointers must be defined as address constants or a reserve of 
$AF words. Such fields must be referenced by their symbolic names. 


6. All external procedure calling sequences that modify their argument list must be 
designed to operate correctly, through the use of $AF, whether assembled for a SAF or 
LAF configuration. 


7. The size of a common block that contains pointers must be specified by an expression 
involving the label SAF to give the correct size, whether the program is assembled for a 
SAF or LAF configuration. 


8. All address manipulation must be performed using base registers (B1—B7). The LAB 
instruction with base plus displacement or base plus index addressing is useful for 
address manipulation. 


SAF/LAF INDEPENDENCE BY LOADING 


This section contains rules for writing assembly language programs that can be executed 
(without reassembly or relinking, but with suitable modifications by the loader) in either aSAF 
or LAF configuration. That is, the source language program can be assembled and linked into a 
bound unit. This bound unit can then be loaded and executed on either a SAF or LAF configuration. 


DIFFERENCES BETWEEN SAF AND LAF 


Memory is allocated and most memory addresses are determined by the Assembler or a 
compiler. SAF and LAF differ in their definition and use of memory addresses. This difference 
affects the following items: 


1. Instructions or data whose size (space allocated) depends on the addressing mode; that is, 


a. Instructions that use IMA operands (and base register instructions that use IMO 
operands). 


b. Declarations of memory addresses as data; that is, address constants or address 
variables. 


2. Data whose location in memory depends on the addressing mode; in particular, data 
structures whose address or format is determined by hardware specifications, such as 
interrupt and trap vector and save areas (IV, TV, ISA, TSA). 
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3. References to such instructions or data. The significant instances of this are: 
a. References to (sequences of) instructions using IMA operands. 


b. References to data structures containing pointers. of;\ 


c. References to data structures defined by hardware. Ye ff 
Such references are resolved by (1) the Assembler or compiler (for most internal or 

common references), (2) the Linker (for some internal references, some common 

references, and external references), or (3) the loader (for some external references and for 

relocation). 


4. Memory addresses, whether in instructions or in data declarations, that contain values 
prior to the start of execution. The significant instances of this are: 


a. IMA operands and IMO operands in base register instructions. 


b. Declarations of pointers with initial values; that is, address constants 
(DC <location-expression). 


These memory addresses must be examined because the value of the memory address 
must be resolved in a single word for SAF and in two words for LAF. 


5. Addressing formats and instructions whose execution is different in the two addressing 
modes. Specifically, the addressing formats for indexing with or without pre-decrement or 
post-increment (the .$R, .+$R, .—$R types) and for push and pop (+$B and —$B) operate 
differently when used with the five base register instructions: 

LDB, STB, CMB, SWB, CMN 


GENERAL RULES FOR WRITING SLIC PROGRAMS 


1. Allocate two words for all memory addresses, whether they are instruction operands or 
data declarations. That is, generate or assemble essentially in LAF. This ensures that 
sufficient space is allocated to execute in LAF. (The Assembler will set $AF equal to 2 
when invoked with the -SLIC control argument.) 


Brig. 


2. When loading a SLIC program for execution in SAF, the loader will: - 3 


a. Replace a sequence of (two word) pointers in an argument list or a pointer array by a 
sequence of one-word pointers followed by an equal number of one word NOPs. That 
is, the sequence is compressed into consecutive words. Adjustment of references to 
such argument lists and pointer arrays is not performed. In the case of an argument 
list, the control word is also adjusted appropriately. 


b. Replace an individual (two word) memory address, whether an instruction operand or 
a data item, by a single-word memory address followed by a one-word NOP. That is, 
the value is moved into the first of the two words. References to the leftmost of the two 
words work for both SAF and LAF execution. 


PROCEDURES FOR WRITING SPECIFIC PARTS OF A SLIC PROGRAM ° 


The following procedures for writing specific parts of a SLIC program are derived from the 
general rules described previously. Methods for handling data structures, pointers, argument “ 
lists, and other commonly used items are described. 


ee eee as == = 


Invoke the language processor with the -SLIC argument. For the Assembler, this sets SAF 
equal to 2. Assembly language programs should use the ARGLST and PTRAY Assembler 
control statements to ‘define argument lists and pointer arrays, respectively. The CALL state- 
ment will also generate an appropriately identified argument list. Individual pointers should be 
defined as address constants or by a RESV statement with the reserved label $AF. 


z 


Sel en 


po 


\. 
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DATA STRUCTURES CONTAINING POINTERS 


The techniques used for declaring, allocating, and referencing data structures containing 
pointers differ somewhat, depending on the kind of data structure. The most commonly used 
data structures containing pointers are classified as follows: 


e Data management structures (FIBs). 

e Argument lists (in calls) and pointer arrays. 
e Request blocks (RBs). 

e Individual pointers. 

e Hardware defined structures. 


For FIBs, two words are allocated for each pointer whether execution is to be in SAF or LAF. 
For argument lists, pointer arrays, and request blocks, one word is allocated for each pointer 
when execution is to be in SAF or two words are allocated when execution is to be in LAF. 


For argument lists and pointer arrays in a SLIC program, the loader compresses the sequence 
of two-word pointers into consecutive single-word pointers for execution in SAF. For request 
blocks, the loader does not compress the structure. 


With this approach, software — including the operating system — has to deal with only one 
form for a given system data structure. For FIBs (and individual pointers), there is only one 
form, regardless of the addressing mode in which the program is executing. For argument lists, 
pointer arrays, request blocks, and hardware defined structures, a program executing in a given 
addressing mode receives only the form corresponding to that address mode. 


An individual pointer must always be addressed by its first (or only) word. This is how the 
hardware works, and is why the loader moves the value into the first word when loading for 
execution in SAF. (Elements of an argument list or a pointer array, other than the first, cannot 
be referenced symbolically, as noted later.) 


References to a pointer should be with instructions that explicitly operate on addresses; e.g., 
LDB. Other instructions, such as those that always operate upon two-word items, should be used 
carefully in a SLIC program. For example, arithmetic operations cannot be performed because 
when they are executed in SAF, the value of a pointer appears in the high-order position (first of 
the two words), not in the low-order position (second of the two words) appropriate for arithmetic. 


DATA MANAGEMENT STRUCTURES (FIBS) 


Data management structures (FIBs) must be allocated with two words for each pointer in 
them. A FIB is not compressed when loaded for execution in SAF; but the loader does move the 
value of the pointer from the second word into the first. 


This kind of structure can be declared symbolically. Honeywell supplies the declaration as a 
macro for use in assembly language programs. 


Data items, including pointers, can be referred to symbolically via the declaration. Refer to a 
data item by the label assigned to it or by an expression not using $AF. 


When referring to pointers with base register instructions, do not use the indexed, push, or pop 
addressing formats. These addressing formats will not work with this kind of structure, because 
they index, increment, or decrement by one-word units when executing SAF and two-word units 
when executing in LAF. 


An initial value can be declared for any data item, including pointers. 


ARGUMENT LISTS AND POINTER ARRAYS 


When argument lists and pointer arrays are used as system data structures (e.g., in inter-program 
communication), a standard form is required. Argument lists and pointer arrays use one-word 
(consecutive) pointers when they are executed in SAF. They must be allocated with two-word 
pointers in a SLIC program, so that it can be executed in LAF. However, they are compressed by 
the loader when they are loaded for execution in SAF. This permits them to be declared with 
initial values — in particular, it minimizes the need to assign values to arguments at execution 
time. 
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Thus, when a SLIC program executes in SAF, the pointers in an argument list or a pointer 
array occupy consecutive words, and the remainder of the structure is initialized to a sequence of 
one-word NOPs. 


Although this kind of structure can be declared with initial values (because it will be altered 
appropriately by the loader for execution in SAF), it should be referenced only by base register 
instructions because the addresses of the pointers in it depend on the addressing mode used at 
execution time. 


Assembly language programs should define argument lists via the CALL statement or 
through use of the ARGLST Assembler control statement. Pointer arrays should be defined by 
the PTRAY Assembler control statement. 


The first pointer of an argument list or pointer array and the control word of an argument list 
can be referred to symbolically. When a SLIC program is loaded for execution in SAF, the 
pointers are compressed from a sequence of two-word values into a sequence of one-word 
(consecutive) values. As a result, references to other data items in this kind of structure must be 
computed at execution time. 


Refer to a pointer in this kind of structure only with base register instructions with indexed, 
push, or pop addressing formats. These addressing formats will work because they index, 
increment, or decrement by one-word units when executing in SAF and two-word units when 
executing in LAF. For example, suppose there are n elements (arguments or elements of a 
pointer array), and the location named N contains the desired element number in the range 1 to 
n. Let register B7 point either to the argument list’s control word or directly to the first word of 
the pointer array. Then, a convenient way of referring to the desired element is: 


For argument lists For arrays 

LAB $B1, $B7.1 LAB $B1, $B7 
LDR $R1,N LDR $R1,N 

LDB- $B2, $B1.-$R1 LDB- $B2, $B1.-$R1 


If the element number is known at assembly time, rather than being a variable as assumed in 
the code sequences above, then the references to N can be replaced by an immediate memory 
operand (=N) or the LDR may be replaced by an LDV if N=127. Do not use the base register plus 
displacement addressing format (as in LDB $B2,$B1.N-1), because that addressing format does 
not adjust for addressing mode. 


REQUEST BLOCKS (RBS) 


A request block must be allocated with two words for each pointer in 1t when it is executed in 
LAF, but only one word for each pointer when it is executed in SAF. In a SLIC program, the 
two-word allocation is not compressed by the loader for execution in SAF. 


A request block cannot be declared symbolically in a SLIC program. Since it has one-word 
pointers when it is executed in SAF and two-word pointers when it is executed in LAF, the same 
declaration cannot be used for execution in both addressing modes. This kind of structure must 
be constructed (have values placed in it) at execution time. 


Data items (including pointers) in request blocks cannot, in general, be referred to symboli- 
cally. Since pointers occupy a different number of words in the two addressing modes, addresses 
within the structure are not known at assembly time. References to data items in a request block 
must be computed at execution time. 


A convenient technique for constructing a request block is to step through it item by item, 
using the automatic incrementation addressing formats. When pointers are referenced, base 
register instructions can be used with the indexed, push, or pop addressing formats. These 
instructions work on either addressing mode because they use one-word units when executed in 
SAF and two-word units when executed in LAF. Do not use the LAB instruction with indexing, 
incrementation, or decrementation, since the LAB uses one-word units in both addressing 
modes. 


An initial value cannot be declared for a data item in a request block. 
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INDIVIDUAL POINTERS 


An individual pointer (“DC <location-expression” in assembly language) can be declared 
symbolically. Each pointer must be declared as an individual data item. 


An individual pointer should be referred to by its label. However, as is the case in SAF/LA¥ 
independence by assembly, an individual pointer can also be referred to by a location expression 
involving the use of $AF. 

When referring to an individual pointer (with a base register instruction), do not use the 
indexed, push, or pop addressing formats. 

An initial value can be declared for an individual pointer. Thus, a SLIC program can contain 


individual address constants (as well as address constants in FIBs, argument lists, and pointer 
arrays). 


HARDWARE-DEFINED STRUCTURES 


Certain data structures are defined by the hardware. These structures have one-word 
pointers when executing in SAF, and two-word pointers when executing in LAF. Structures of 
this kind are: 


e Base register areas used with SAVE and RSTR instructions. The same mask should be used 
to restore registers as was used to save them, and the save area must have two words 
reserved for each base register to be saved. 

e Trap and interrupt vectors and save areas: 

User programs must reference trap save areas in the same way that request blocks are 
referenced; i.e., the addresses needed must be computed at execution time. Only the 
operating system is allowed to access the trap vectors, interrupt vectors, and interrupt 
save areas. 

e Queue frames and stack headers: 


Queue frames and stack headers are treated the same as request blocks for the purpose of 
creating a SLIC program. 


IMMEDIATE MEMORY ADDRESS OPERANDS 


An immediate memory address (IMA) operand (“< location-expression” in assembly 
language) cannot be followed by other fields of the instruction because the loader would not 
move those other fields when loading for execution in SAF. The loader places the value of the 
IMA operand only into the first word, and sets the second word to a NOP. 


This constraint applies to the following instructions: 
e Input/output instructions — IO, IOH, and IOLD. 


e Bitinstructions — LB, LBC, LBF, LBS, and LBT; these instructions cannot be masked, but 
can be indexed if they use the IMA operand field. 


e SAVE, RSTR, SRM. | 


Other instructions either do not allow IMA operands or have only one possible address 
operand and do not have control fields following, so they can be used without restriction. 


ABSOLUTE ADDRESSES 


Only the operating system and certain system programs such as Debug need to reference 
absolute memory locations. If any programs that need absolute addressing are to be written as 
SLIC programs, all absolute addresses must be generated at execution time. 
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Appendix M 


Reentrant Programs 


A program is defined as reentrant if a single copy of its code can be simultaneously executed by 

several tasks; the tasks may be in the same task group or in different task groups. 

There are two categories of reentrant assembly language programs: — 

1. “Code only” programs that use no statically (permanently) allocated data storage (except 
the hardware registers). Data storage required by such programs is dynamically allo- 
cated. Normally, only system programs and small service subroutines (e.g.; binary to 
decimal conversion) are written this way. 


2. Programs in which the code and statically allocated data are separated by the use of 
common blocks, with the allocation of static data storage being managed by the system. 


Programs belonging to the second category are discussed below. It 1s assumed that the 
reentrant programs must operate in both MOD 400 and MOD 600. The use of dynamically 
allocated data storage is not discussed in this appendix. 


A reentrant program defines the following three address spaces and their initial content: 
e Pure code section 
e Local data section 
e Nonlocal data section 
Pure code consists of pure procedures and constants. A pure procedure is one that never 
modifies any part of itself during execution. One copy of the pure code is shared by all users of the 
reentrant program. 
Local data is data that has a scope of identification no greater than the source unit in which it 
is declared. All other data is considered to be nonlocal. 
In an assembly language program, these three sections are identified as follows: 
1. Anything that does not have its origin defined as any kind of acommon block is part of the 
pure code section. 
2. Anything that has its origin defined in the local common block named $LCOMW is part of 
the local data section. 
3. Anything that has its origin defined in a local common block other than $LCOMW or ina 
nonlocal common block is part of the nonlocal data section. 
The distinction of local data from nonlocal data is strictly for addressing purposes; the Linker 
combines them into a single load element. 
The use of pointer data is restricted as follows: 
1. A pointer, including IMA operands and IMO operands of the five base register instruc- 
tions, in a pure code section may refer only to objects in a pure code section. 
2. A pointer in a data section may refer only to objects in a data section; it may not refer toa 
pure code section. 
All references made by executable code to local data must use B6 relative addressing. The first 
word of local data is referenced by $B6.8LCOMW, the second by $B6.8LCOMW +1, etc. 
The program has no direct access to nonlocal data. Instead, the program must use indirect 
addressing through the local data to reference nonlocal data. Normally, this is done as follows: 
1. Allocate a pointer in the local data section initialized with the address of the common 
block (or some location within it) to be referenced, 


2. Load that pointer into a base register, other than B6, using B6 relative addressing, and 
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3. Access the nonlocal data using base relative addressing with the base register loaded in 


step 2. 
The second step given above may be omitted when a base register is known to contain a 
pointer to the desired common block. ms 
When a set of programs, written as described above, is linked in a “Link Separate environ- YW / 


ment”, the Linker maintains the separation of code from data by placing the code and data in 
different load elements. The Linker also adjusts all B6 relative displacements, referring to local 
data, found in the code to reflect the positioning of that local data in the data load element. At 
execution time, the loading of a data load element causes B6 to be set to provide addressability to 
that data. 


Example: 


Assume there are two programs: ABLE and BAKER. Assume that ABLE declares and 
references common blocks A and B, and that BAKER declares and references common 
blocks B and C. The programmer will “see” ABLE and BAKER as shown below. 


$B6.0 


ABLE: 
pure code local common common common 
section block $LCOMW block A block B 
local data section nonlocal data section: 
$B6.0 
BAKER: a 
Q 
pure code local common common common 
section block $LCOMW block B block C 
anne nn nnn ne enema 


local data section nonlocal data section 


After ABLE and BAKER are linked as a bound unit, the executing code sees the following: 


ee eee 


= 
ABLE’s pure BAKER’s pure 
code section code section 


combined pure code section 


a 


ABLE’s local common common BAKER’s local common 
data section block A block B data section block C 


combined data section 


In the above illustration, the Linker has adjusted the displacement in all of BAKER’s B6 ff | “ 
relative references to its local data by the size of ABLE’s local data plus the size of common block oy 
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A plus the size of common block B. This assumes that the bound unit was linked for MOD 400 
and the size of the combined data section is less than 32K words. If the bound unit was linked for 
MOD 600 or the size of the combined data section is greter than 32K words, B6 would point toa 
location 32K words, B6 would point to a location 32K words further to the right, and the 
displacement in all of ABLE’s and BAKER’s B6 relative references to their local data would 
have an additional adjustment of —32768 words. 


The preceding example only considered programs linked into the root of a bound unit. When a 
reentrant program has overlays, some formal call/return mechanism, such as the Call/Cancel/ 
Exit Controller, must be used to save the calling overlay’s B6 and set the called overlay’s B6 on 
the call and to restore the calling overlay’s B6 on the return. 


The use of B6 relative addressing to reference local data places some limitations on the scope 
of data in a reentrant bound unit having overlays when compared to non-reentrant bound units. 
Data that may be referenced from a particular overlay of a bound unit linked in a “Link Separate 
environment” consists of: 


1. That overlay’s local data. This data may be referenced directly using B6 relative addressing. 


2. That overlay’s nonlocal data. This data may be referenced indirectly via a pointer 
contained in the overlay’s local data. 


3. When an overlay is formally called by another overlay, it may access any data received as 
a formal parameter using standard methods for accessing parameters. 


The following is a summary of the rules for writing reentrant programs with statically 
allocated data. 


1. Data must be separated from code through the use of common blocks and local common 
blocks. All local data must be placed in the local common block named $LCOMW (i.e., 
$LCOMW must be declared by the Assembler control statement “$LCOMW LCOMM 
int-val-expression”). 

2. Inthe executable code, all references to local data must be through B6 relative addressing; 
e.g., $B6.$LCOMW +int-val-expression. 


3. Inthe executable code, all references to nonlocal data must be made via pointers (to the 
nonlocal data) contained in the local data. 


4. The program must be linked in a “Link Separate environment”. A “Link Separate 
environment” is specified by the -R control argument of the LINKER command in MOD 400 
or through the use of LINKS Linker commands in MOD 600. 
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